nginx故障转移对客户端完全透明，不返回“正在重试”提示；可通过前端捕获502/503/504错误后主动重试并提示，或服务端添加x-upstream-retry响应头标识是否发生重试。

Nginx 本身不向客户端返回“正在重试”的提示信息，也不会在故障转移过程中主动通知浏览器或调用方“当前请求已换节点重试”。它的故障转移是完全透明、服务端内部完成的——客户端只看到最终响应（成功或失败），无法感知中间是否发生了节点切换。

所以，“配置客户端自动重试提示”这个需求，在标准 Nginx 架构中无法直接实现。但你可以通过以下方式间接达成类似效果或提升用户体验：

客户端侧可感知的重试行为（需配合前端逻辑）

Nginx 不发提示，但你可以让前端在特定失败场景下主动重试，并显示友好提示：

Nginx Config Linter

对 Nginx 配置文件进行语法检查、验证和安全、性能审计。

下载

• 当收到 502/503/504 等网关类错误时，前端 JS 判断后自动发起第 2 次请求，并显示“网络不稳定，正在重试…”
• 示例逻辑（简化）：

  async function fetchWithRetry(url, maxRetries = 2) {
    for (let i = 0; i = 500 && res.status 

服务端侧可增强的“可观察性”提示

虽然不能实时提示“正在重试”，但可通过响应头传递线索，辅助排查或前端决策：

• 在 location 块中添加自定义响应头，标记本次请求是否经历了重试：

  map $upstream_addr $retry_flag {
      default "";
      ~,.* "retry";
  }
  server {
      location /api/ {
          proxy_pass http://backend;
          proxy_next_upstream error timeout http_502 http_503 http_504;
          proxy_next_upstream_tries 3;
  
          add_header X-Upstream-Tried $upstream_addr;
          add_header X-Upstream-Retry $retry_flag;
      }
  }

  • $upstream_addr 记录实际通信的后端地址（如 192.168.1.10:8080, 192.168.1.11:8080），含逗号表示发生过重试
  • 前端可读取 X-Upstream-Retry: retry 判断该次响应来自非首节点，用于日志上报或灰度反馈

注意：Nginx 重试对客户端是无感的，且有严格前提

• 仅当尚未向客户端发送任何响应字节时，Nginx 才会触发 proxy_next_upstream 切换；
• 一旦开始返回内容（比如后端已输出部分 HTML 或 JSON），Nginx 就不会再换节点——此时重试已失效；
• POST/PUT 等非幂等请求默认不重试（除非显式加 non_idempotent），避免重复提交。

不复杂但容易忽略。