要让Nginx统一返回200状态码展示降级页，关键是在同一location中启用proxy_intercept_errors on，并用error_page 502 503 504 =200 /offline.html显式覆盖状态码，同时配置internal location = /offline.html提供页面，且后端必须真实返回对应错误码。

要让 Nginx 用统一状态码（比如全部返回 200）展示降级页，关键不是只开 proxy_intercept_errors on，而是靠 error_page 的 =N 语法 显式覆盖原始状态码。这个操作必须在同一个 location 中完成，且依赖后端真实返回目标错误码（如 502/503/504）才能触发拦截。

必须在同一 location 中启用拦截并重写状态码

仅开启拦截不改变响应状态；只有 error_page 后紧跟 =N 才能真正替换状态码：

• 在含 proxy_pass 的 location 块中写：proxy_intercept_errors on;
• 紧接其后声明：error_page 502 503 504 =200 /offline.html;（注意等号前无空格）
• 确保该 location 下没有其他指令（如 try_files 或重写规则）意外覆盖 error_page 行为

降级页路径需有 internal location 支持

/offline.html 这类 URI 不是静态文件路径，而是内部路由标识，必须由 Nginx 自己提供服务：

WebChat Voice Proxy

⚠️ 已弃用 — 该技能已拆分为两个独立技能，以提升模块化程度：**webchat-https-proxy**（HTTPS/WSS 反向代理）和 **webchat-voi...**

下载

• 添加独立的 internal 块：location = /offline.html { root /usr/share/nginx/html; internal; }
• internal 防止用户直接访问该路径绕过业务逻辑
• 确认文件存在、权限可读，且内容大小超过 512 字节（避免旧浏览器忽略自定义页）

确保后端确实返回了可拦截的状态码

proxy_intercept_errors 只识别响应头中的标准 HTTP 状态码，不分析响应体：

• 用 curl -I http://your-domain/api 检查后端是否真返回 502/503/504，而非 200 + 错误文本
• 若后端熔断时返回 200，需先调整后端行为，或改用 Lua 模块做响应体判断
• Nginx 自身生成的 502/503/504（如 upstream 全不可达）也受此机制控制

避免常见失效点

看似配了却仍透传原始错误码，往往卡在这几个细节：

• error_page 写在 server 块但 proxy_intercept_errors 在 location 块 → 作用域不匹配，不生效
• 写了 error_page 502 =200 /offline.html，但没配 location = /offline.html → Nginx 返回 404 或 500
• 降级页路径用了 alias 却漏掉末尾斜杠，或 root 路径拼错 → 文件找不到，回退到默认错误页