Nginx轮询需手动配置超时与重试机制才能实现失败自动换节点:设proxy_connect_timeout(3–5s)、proxy_read_timeout(10s)、proxy_send_timeout(8–10s);启用proxy_next_upstream(error timeout http_502/503/504 invalid_header)、proxy_next_upstream_tries(3或5)、proxy_next_upstream_timeout(10s);配合upstream中max_fails=3 fail_timeout=30s实现健康剔除。

Nginx 的轮询本身不带重试能力,要让它在某个后端失败时自动换节点重发请求,必须手动配好连接超时和重试触发机制。核心是三类参数协同:建连控制、响应等待、失败判定与跳转逻辑。
设置合理的单次连接与读取超时
这些值决定一次请求是否“算失败”,直接影响重试是否被触发:
- proxy_connect_timeout:控制与后端建立 TCP 连接的最长时间,建议设为 3–5s。太长会卡在宕机节点上,太短可能误判高延迟但可用的服务。
- proxy_read_timeout:等待后端返回完整响应的上限,建议 10s 左右。若业务本身响应慢(如报表导出),可适当放宽,但不宜超过 30s。
-
proxy_send_timeout:发送请求体给后端的超时,一般设为与
proxy_read_timeout相同或略小,比如 8–10s。
开启并限定重试行为
仅设超时还不够,必须明确告诉 Nginx 哪些情况要换节点重试,以及最多试几次、总耗时多少:
-
proxy_next_upstream:必须显式配置,否则即使超时也只发一次就报错。推荐组合:
error timeout http_502 http_503 http_504 invalid_header
其中error覆盖建连失败,timeout覆盖连接/读写超时,invalid_header拦截空响应或格式错误的假存活服务。 - proxy_next_upstream_tries:限制整个重试过程最多尝试次数(含首次),建议设为 3 或 5,避免无限循环加重后端压力。
- proxy_next_upstream_timeout:整个重试流程的总耗时上限,建议 10s。超过即返回 502/504,不等所有重试走完。
配合健康检查避免反复试探故障节点
如果某台服务器持续失败,每次轮到它都要先试一次再重试,效率低还拖慢整体。需要让 Nginx 主动把它暂时剔除:
- 在
upstream的每个server行后加上:max_fails=3 fail_timeout=30s
表示连续 3 次由proxy_next_upstream判定的失败后,该节点被标记为不可用,30 秒内不再参与轮询分发。 - 这个机制和重试是联动的:重试失败计入
max_fails计数,而节点被标记为不可用后,后续请求直接跳过它,不触发重试——真正实现“跳过 + 备用”闭环。
配置位置与常见避坑点
- 所有
proxy_*指令需放在location块内,不能只写在server或http级; -
upstream块中不要漏掉max_fails和fail_timeout,否则健康剔除失效; - 避免在
proxy_next_upstream中加入http_404或http_500:前者是路径问题,后者多属业务异常,重试可能重复提交或放大错误; - 若后端使用 HTTP/1.0 或未正确返回状态码,
invalid_header可防止 Nginx 把乱响应当成功处理。











