Nginx 中轮询调度算法的平滑重试机制配置
Nginx中不存在“轮询调度算法的平滑重试机制”这一统一概念；轮询是请求分发策略，重试是故障转移行为，二者职责分离；平滑重试需通过proxy_next_upstream配合健康检查与合理参数协同实现。
Nginx 中并不存在“轮询调度算法的平滑重试机制”这个统一概念——轮询（round-robin）是请求分发策略，而重试（retry）是故障转移行为，二者职责分离、机制独立。真正需要配置的是：在轮询基础上，如何让失败请求“平滑地”切换到其他健康节点重试，这依赖 proxy_next_upstream 配合健康检查与合理参数协同实现。
一、proxy_next_upstream 是重试的核心开关
它不改变轮询顺序，而是在某次转发失败后，主动跳过当前节点，按 upstream 当前可用列表继续轮询下一个节点。
关键配置示例：
upstream backend { server 192.168.1.10:8080 max_fails=3 fail_timeout=30s; server 192.168.1.11:8080 max_fails=3 fail_timeout=30s; server 192.168.1.12:8080 backup; # 故障兜底}location / { proxy_pass http://backend; proxy_next_upstream error timeout http_502 http_503 http_504 invalid_header; proxy_next_upstream_tries 3; proxy_next_upstream_timeout 10s;}
-
error timeout：覆盖网络层异常（建连失败、响应中断） -
http_502/503/504：覆盖后端崩溃、过载或上游网关超时，换节点成功率高 -
invalid_header：拦截“假存活”响应（如空响应体、缺失 Status 行）
⚠️ 不要加 http_404 或 http_500：前者是业务路径问题，后者多为逻辑错误，重试会放大风险。
二、靠健康检查避免“无效重试”
没有健康检查，proxy_next_upstream 只是“失败→换一个再试”，可能连续命中已宕机节点。
必须为每个 server 显式配置：
-
max_fails=3：连续失败 3 次即标记为不可用 -
fail_timeout=30s：30 秒内不再调度该节点
这样，重试时实际参与轮询的节点已是实时健康的子集，切换才有意义。
更进一步可启用主动健康检查（需 OpenResty 或 Nginx Plus）：
health_check interval=3 fails=2 passes=2;
比被动等待更快剔除故障节点，缩短重试窗口。
三、权重与重试共存时的行为逻辑
加权轮询（如 weight=3 和 weight=1）影响的是正常请求的分配比例，不影响重试路径。
重试始终按 upstream 当前可用节点的轮询顺序进行（非按权重重新计算），但会跳过已被 max_fails 标记为 down 的节点。
例如 upstream 有 A(weight=3)、B(weight=1)、C(weight=1)，若 A 已被标记为 down，则重试只在 B 和 C 间轮询，此时 B:C = 1:1，而非 1:1 的原始权重比被临时“归一化”。
四、幂等性是平滑重试的前提
重试本质是重复发送请求，只有无副作用的操作才安全：
- ✅ GET / HEAD：天然幂等，可放心开启全类型重试
- ⚠️ POST / PUT / DELETE：必须由业务层保障幂等（如带唯一 request_id、服务端去重）
- ❌ 不加判断直接对非幂等接口开启
http_502重试，可能导致重复下单、扣款、创建资源等严重问题
建议将非幂等接口单独路由，禁用重试，或仅限 error timeout 级别兜底。
不复杂但容易忽略。
