配置 nginx 处理上游慢响应,核心在于调整 `proxy_read_timeout`、`proxy_send_timeout` 和 `proxy_connect_timeout` 三个指令的值。这些参数分别控制读取响应、发送请求和建立连接的超时时间,默认值通常为 60 秒。若上游服务响应缓慢导致 nginx 返回 502 或 504 错误,需根据实际业务需求增大这些数值,并确保 nginx 与上游之间的网络链路稳定。

如何区分连接、发送和读取超时的具体场景
这三个超时参数针对 TCP 连接生命周期的不同阶段生效。`proxy_connect_timeout` 限制 Nginx 与上游服务器建立 TCP 连接的时间;`proxy_send_timeout` 限制 Nginx 向上游发送整个请求体的时间;`proxy_read_timeout` 则定义两次成功读取操作之间的最大间隔。理解它们的区别有助于精准定位是连接不上、发不出数据还是等不到响应。

server {
listen 80;
server_name example.com;
location /api/ {
proxy_pass http://backend_upstream;
# 连接超时:尝试连接后端时等待的最长时间
proxy_connect_timeout 10s;
# 发送超时:向后端发送请求体期间,两次写入操作的最大间隔
proxy_send_timeout 30s;
# 读取超时:从后端读取响应期间,两次读取操作的最大间隔
proxy_read_timeout 60s;
}
}
上述配置中,如果后端在 10 秒内未接受连接,Nginx 将立即断开并报错。一旦连接建立,Nginx 开始发送请求头和数据,若在 30 秒内没有完成发送动作(即两次写入间隔超过 30 秒),连接也会中断。最后,当请求到达后端后,Nginx 等待后端返回数据,若 60 秒内未收到任何字节,则判定为读取超时。这种分层控制允许对不同的网络瓶颈进行精细化调整。
长轮询或流式接口需要特殊配置吗
对于 SSE(Server-Sent Events)或 WebSocket 等长连接场景,默认的超时设置往往会导致连接被意外切断。这类接口通常要求 `proxy_read_timeout` 设置得非常大,或者设置为 0 以禁用超时检查。同时,必须配合 `proxy_http_version 1.1` 和 `Connection: upgrade` 头部传递,以确保底层协议不被 Nginx 的 HTTP/1.0 逻辑干扰。

server {
listen 80;
server_name example.com;
location /sse-stream {
proxy_pass http://backend_upstream;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
# 禁用读取超时,防止长连接被切断
proxy_read_timeout 86400s;
proxy_send_timeout 86400s;
}
}
在此场景中,`proxy_read_timeout` 被设为 86400 秒(一天),确保只要连接保持活跃,Nginx 就不会主动断开。注意,这里的“活跃”指的是数据流的持续流动,如果中间有极长的静默期且超过了该阈值,连接仍会断开。对于 WebSocket,除了超时设置,还需确保上游服务器正确响应 101 Switching Protocols 状态码,否则 Nginx 可能无法正确切换协议模式。
当上游完全无响应时 Nginx 的行为是什么
如果上游服务器彻底宕机或防火墙丢弃了数据包,Nginx 会根据配置的超时时间等待,直到触发相应的超时事件。此时,Nginx 不会无限期挂起客户端请求,而是会向客户端返回一个错误页面,通常是 502 Bad Gateway 或 504 Gateway Timeout。具体的错误类型取决于触发的是哪个超时阶段,但客户端最终都会收到明确的失败信号,而不是永久加载。











