Nginx 无法直接基于响应状态码发起新请求重试，而是通过 proxy_next_upstream 在单次请求失败后自动转向备用 upstream server；需显式配置 http_502、http_503 等参数启用状态码重试，且仅对 upstream 返回的错误码生效，不适用于 Nginx 自身生成的 5xx 或 4xx 错误。
在 Nginx 中，无法直接基于响应状态码触发自动重试（比如 502/503 时自动转发请求到备用上游），因为 Nginx 的 proxy_next_upstream 指令虽支持按状态码判定“是否切换上游”，但它是在代理阶段（upstream 阶段）对后端响应做判断，并非“收到错误码后再发一次请求”，而是“本次请求失败后，用同一客户端请求重试另一个 upstream server”。真正的“自动重试”需结合该指令与合理配置实现，而非应用层循环调用。
理解 proxy_next_upstream 的作用范围
该指令控制的是：当 Nginx 向 upstream server 发起代理请求后，若遇到指定条件（如超时、连接失败、或返回特定状态码），Nginx 会尝试将同一个客户端请求转发给 upstream 组中的下一个 server。它不改变客户端看到的响应，也不发起额外的独立请求。
- 默认只对
error（连接拒绝/断开）、timeout重试，不包含 500 类状态码 - 要启用状态码重试，必须显式添加，例如：
proxy_next_upstream error timeout http_502 http_503; - 注意：
http_500等仅对 upstream 返回的响应生效；若 Nginx 自身生成 500（如配置错误），不触发重试
配置示例：对 502/503 响应自动切到备用后端
以下是一个典型 upstream + proxy 设置，实现后端返回 502 或 503 时，由 Nginx 自动尝试另一台服务器：
upstream backend {
server 192.168.1.10:8080;
server 192.168.1.11:8080 backup; # 备用节点
}
<p>server {
location / {
proxy_pass <a href="https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e">https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e</a>;
proxy_next_upstream error timeout http_502 http_503;
proxy_next_upstream_tries 3; # 最多重试 2 次（共 3 次尝试）
proxy_next_upstream_timeout 3s; # 单次请求总超时（含重试）</p><pre class="brush:php;toolbar:false;"> proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
说明：若第一台 server 返回 502，Nginx 会立即用相同请求向第二台（backup）再发一次；若也失败且满足重试条件，则可能再次尝试（取决于 tries 和 timeout）。
关键限制与注意事项
这类重试机制有明确边界，误用可能导致问题：
- 非幂等请求慎用：POST/PUT 等请求被重试时，后端可能重复处理（如重复下单），Nginx 不校验业务逻辑
-
不适用于 4xx 错误：4xx 是客户端问题（如 404、400），重试无意义，
proxy_next_upstream默认也不包含它们 -
重试不等于兜底响应：若所有 upstream 都失败，最终仍返回最后一个 server 的响应（如 503），需配合
error_page提供静态兜底页 -
日志中体现为单次请求多次 upstream 访问：可通过
$upstream_addr和$upstream_status查看每次尝试的目标和状态
补充方案：用 error_page 实现状态码分级响应
若目标是“收到 502 就返回自定义页面或跳转”，而非重试，应使用 error_page：
location / {
proxy_pass https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e;
proxy_intercept_errors on; # 允许拦截后端返回的错误响应
<pre class="brush:php;toolbar:false;">error_page 502 503 /fallback.html;
}
location = /fallback.html { internal; root /usr/share/nginx/html; }
该方式不重试，而是直接响应预设内容，适合故障期间的用户体验降级。
