Nginx轮询需配合proxy_next_upstream、三项超时参数(connect/send/read)及max_fails/fail_timeout才能实现毫秒级快速失败与节点跳过;否则将卡住等待或重试失效。

轮询本身不重试,必须靠 proxy_next_upstream 显式触发失败转移,再配合超时和健康检查,才能做到“快速失败、立刻换台”。关键不是让请求多等一会儿,而是让它在毫秒级内判定失败、跳过故障节点、落到下一个可用后端。
必须配置的三项基础超时参数
没有它们,Nginx 会卡住等待,根本来不及重试:
- proxy_connect_timeout 3s; —— 连不上就立刻放弃,不等 TCP 重传耗尽时间
- proxy_send_timeout 5s; —— 请求体发不出去,5 秒内中断,避免堆积
- proxy_read_timeout 8s; —— 后端已连接但没返回响应头,8 秒内判定为 timeout 并触发重试
用 proxy_next_upstream 精准控制重试时机
只写 proxy_pass 不会重试。必须在 location 块中明确开启,并限制范围:
-
proxy_next_upstream error timeout http_502 http_503 http_504; —— 遇到连接失败、超时或典型网关错误才换节点;不加
http_500可避免业务异常也被重试 - proxy_next_upstream_tries 2; —— 最多尝试 2 次(含首次),防止单个请求打遍所有后端
- proxy_next_upstream_timeout 10s; —— 整个重试过程总耗时不超过 10 秒,超时直接返回错误
让节点真正“被跳过”,而不是反复试探
光重试不行,得让故障节点短时退出轮询队列:
- 在
upstream的每个server行后加上:max_fails=2 fail_timeout=5s; —— 连续失败 2 次,5 秒内不再分发新请求 - 这个“失败”由
proxy_next_upstream触发的 error/timeout/5xx 计入,不是独立统计 - 5 秒后首个新请求会自动试探该节点:成功则恢复,失败则继续屏蔽
避免常见失效陷阱
很多配置看似写了,实际不起作用:
-
proxy_next_upstream 必须写在
location或server块里,不能放在upstream块中 - 如果用了
ip_hash或least_conn,轮询逻辑已失效,重试行为可能混乱 - 漏写分号、
weight位置错、或max_fails值为 0,都会导致整个 upstream 加载失败 - 未配
proxy_http_version 1.1;和proxy_set_header Connection '';,每次重试都新建连接,放大延迟











