nginx代理超时重试需显式配置proxy_next_upstream error timeout、分层设置connect/send/read/next_upstream_timeout、限制tries≤3且upstream至少2节点、慎用non_idempotent并规避前端超时冲突。
要在 Nginx 中实现代理超时后自动重试其他后端节点，核心不是加几个 timeout 就能生效，而是把触发条件、重试边界、上游可用性三者配齐。缺一不可。
必须显式开启 timeout 重试条件
Nginx 默认只对连接失败（error）重试，timeout 虽在默认列表里，但容易被覆盖或忽略。务必在 location 或 server 块中写明：
- proxy_next_upstream error timeout; —— 这是最小必要配置
- 如需对网关类错误也重试，可追加：http_502 http_503 http_504
- 避免加 http_404 或 http_500：前者多是路径/参数问题，后者常为业务异常，重试无意义
超时参数要分层设置且逻辑自洽
单次请求各阶段超时和整体重试窗口必须匹配，否则重试可能根本没机会执行：
- proxy_connect_timeout 3s; —— 建立 TCP 连接上限，建议 ≤ 5s
- proxy_send_timeout 5s; —— 发送完整请求体的上限
- proxy_read_timeout 8s; —— 等待响应头或体的上限，按业务接口平均耗时设
- proxy_next_upstream_timeout 12s; —— 从第一次请求发出起计时的总耗时上限（含所有重试+网络延迟）
例如：read_timeout=8s、tries=3 时，timeout 设 12s 比较合理——前两次若接近超时，第三次只剩余量极少，会快速失败返回，不拖慢用户。
重试次数与上游节点数必须达标
重试不是“转发再转发”，而是“换一台机器再试”，所以依赖 upstream 至少有 2 个可用节点：
- proxy_next_upstream_tries 3; —— 最多重试 3 次（含首次），不是额外重试 2 次
- upstream 必须定义 ≥2 台 server，例如：
server 10.0.1.10:8080 max_fails=2 fail_timeout=30s;
server 10.0.1.11:8080 max_fails=2 fail_timeout=30s;
}
没有备用节点，哪怕配置全对，重试也永远不会发生。
注意非幂等请求与前端超时的冲突
POST/PUT/DELETE 默认不重试，强行加 non_idempotent 风险极高：
- 下单、支付、扣库存等操作一旦重复执行，可能引发资损或状态错乱
- 长耗时接口（如 Excel 导入）建议单独用 location 关闭重试：proxy_next_upstream off;
- 前端 Ajax 超时（如 fetch timeout=15s）必须大于 Nginx 的 proxy_next_upstream_timeout，否则用户已断开，Nginx 重试成功也无意义
