proxy_intercept_errors默认不生效，因Nginx默认透传后端50x错误；需显式开启并配合error_page指令及静态路径映射，才能实现拦截与降级。
开启 proxy_intercept_errors on 是实现后端错误自动降级的关键前提，但仅此不够——必须配合 error_page 指令与静态资源路径的精确映射，才能让 Nginx 在收到 50x 响应时主动拦截并返回预设的降级页。
为什么 proxy_intercept_errors 默认不生效？
Nginx 默认不会拦截后端返回的错误响应（如 502/503/504），而是直接透传给客户端。只有显式启用 proxy_intercept_errors on，Nginx 才会在收到 >=300 的响应状态码时，尝试查找匹配的 error_page 指令。注意：该指令必须放在 location 块中（或更外层作用域），且仅对 proxy_pass、fastcgi_pass 等代理类指令生效。
正确配置 error_page 实现 50x 降级
需明确指定哪些状态码触发降级，并指向本地静态文件。常见写法如下：
- 在
location /或具体代理块中添加：proxy_intercept_errors on;error_page 500 502 503 504 /static/maintenance.html; - 确保
/static/maintenance.html路径可被 Nginx 访问，例如通过alias或root配置静态服务：location = /static/maintenance.html {<br> alias /usr/share/nginx/html/maintenance.html;<br> } - 避免使用
return直接返回状态码（如return 503），否则会绕过proxy_intercept_errors机制。
进阶技巧：按上游状态精细化降级
可通过 map 指令结合 $upstream_http_x_backend_status（需后端配合输出）或 $upstream_status 变量，实现差异化响应。例如：
- 定义变量映射：
map $upstream_status $fallback_page {<br> 502 "/static/timeout.html";<br> 503 "/static/unavailable.html";<br> default "/static/error.html";<br> } - 在 location 中引用：
error_page 500 502 503 504 = @fallback;<br> location @fallback {<br> internal;<br> rewrite ^(.*)$ $fallback_page break;<br> }
验证与调试要点
配置后务必验证是否真正生效：
- 用
curl -I http://your-domain/触发后端 502（如临时停掉上游服务），观察响应头中Server是否为 Nginx，且返回内容是静态页而非上游原始错误； - 检查 Nginx 错误日志（
error_log），若看到upstream sent too big header或no resolver defined类提示，说明拦截前已出错，需先解决代理层问题； - 确保降级页本身能被正常访问（单独请求
/static/maintenance.html应返回 200），否则会陷入 500 循环。
