Nginx 504 Gateway Time-out 超时报错排查及超时时间配置规范.docxVIP

Nginx504GatewayTime-out超时报错排查及超时时间配置规范

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

版本：v2.0|发布日期：2026-07-22

适用环境：Linux(CentOS/Ubuntu/Debian)/Docker/Kubernetes

适用组件：Nginx1.18+/PHP-FPM/Tomcat/Node.js/SpringBoot/gRPC

本文档适用于内网物理隔离环境离线参考。所有命令均已在CentOS7/8、Ubuntu20.04/22.04生产环境验证通过。

第一章报错原理解析与场景归纳

1.1504GatewayTime-out的底层通信原理

Nginx作为反向代理向后端upstream发起请求后，会进入等待响应阶段。Nginx在此阶段维护一个定时器，其时长由proxy_read_timeout（默认60秒）控制。当后端在此时长内未返回任何HTTP响应头数据，Nginx会主动断开与后端的连接，并向客户端返回504GatewayTime-out，同时在error.log中记录系统调用错误码errno=110（ETIMEDOUT）。

与502不同的是，504意味着后端进程存活且TCP连接已建立，但处理速度