nginx 接口降级需开启 proxy_intercept_errors 并配合 error_page，仅拦截 ≥300 状态码；必须用 internal location 提供安全降级响应，支持按错误类型差异化处理，并结合 upstream 健康检查减少触发频率。
Nginx 处理状态码实现接口降级，核心不是“拦截所有错误”，而是精准识别后端返回的失败信号，并在第一时间接管响应流程。关键在于让 Nginx 主动干预，而不是被动透传。
必须开启 proxy_intercept_errors 才能触发降级逻辑
这个指令默认关闭，不写就等于没配置。它只对 proxy_pass 流量生效，且仅拦截 ≥300 的 HTTP 状态码（如 502、503、504）。只加这一行不够，必须和 error_page 配合使用，否则 Nginx 仍会把原始错误原样返回给用户。
- 在代理 location 中添加：
proxy_intercept_errors on; - 紧接着绑定要处理的状态码：
error_page 500 502 503 504 = @api_degrade;
注意等号=表示内部重定向，保留原始状态码；@api_degrade是命名 location，不可被外部直接访问。
用 internal location 安全提供降级响应
命名 location 必须设为 internal，并明确指定静态资源路径或直接返回内容，避免暴露文件系统结构或被绕过：
location @api_degrade {
internal;
root /usr/share/nginx/html;
try_files /api-degrade.json =404;
}
-
/api-degrade.json是一个本地 JSON 文件，例如{"code":5001,"msg":"服务暂不可用"} - 若希望返回 HTML 页面，可换成
/maintenance.html，但建议内联样式和脚本，避免二次请求失败 - 不要用
return 503或rewrite，它们会跳过proxy_intercept_errors机制
按错误类型区分降级策略更实用
不同状态码反映不同故障原因，统一处理虽简单，但不利于前端判断和用户提示：
-
error_page 502 504 /timeout-fallback.html;（上游连接超时或网关无响应） -
error_page 503 /maintenance-fallback.html;（后端主动限流或维护中） -
error_page 500 /error-fallback.html;（后端程序异常崩溃）
每个页面可包含对应文案、自动重试逻辑或客服入口，提升可维护性与用户体验。
结合 upstream 健康检查减少降级触发频率
降级是兜底，预防才是重点。通过节点级熔断降低错误发生概率：
- 在
upstream中设置：server 10.0.1.10:8080 max_fails=2 fail_timeout=30s; - 配合：
proxy_next_upstream error timeout http_502 http_503 http_504;
这样 Nginx 会在首次失败后尝试其他节点，只有全部不可用时才真正返回错误，再由proxy_intercept_errors拦截并降级。
不复杂但容易忽略
