proxy_intercept_errors 是拦截许可而非自动跳转开关，需配合 error_page 才生效；可按路径、上游服务或响应头实现差异化降级。
明确 proxy_intercept_errors 的定位
proxy_intercept_errors 不是自动跳转开关，它只是一个“拦截许可”。开启后，Nginx 才会检查后端返回的 4xx/5xx 响应，并尝试交由 error_page 处理；但若未配置对应状态码的 error_page，它依然透传原始错误。所以差异化降级的前提是：开启该指令 + 精准绑定 error_page + 区分触发条件。
按请求路径区分降级页
不同业务模块对可用性要求不同，比如 /api/order 要求强一致性，而 /static/banner 可完全静态兜底。可通过嵌套 location 实现路径级隔离：
- 在主 location 中不设全局 error_page，避免粗粒度覆盖
- 为关键路径单独声明 error_page：
location /api/order {
proxy_pass http://order_upstream;
proxy_intercept_errors on;
error_page 502 504 = @order_fallback;
} - 为非关键路径设置轻量降级：
location /static/ {
proxy_pass http://cdn_upstream;
proxy_intercept_errors on;
error_page 502 504 = @cdn_fallback;
}
按上游服务动态匹配降级页
当多个 upstream 对应不同后端集群（如 user-svc、pay-svc、search-svc），可借助 map 指令提取 $upstream_addr 或自定义响应头（如 $upstream_http_x_service_name），实现服务维度的降级路由：
WebChat Voice Proxy
下载
⚠️ 已弃用 — 该技能已拆分为两个独立技能，以提升模块化程度：**webchat-https-proxy**（HTTPS/WSS 反向代理）和 **webchat-voi...**
- 定义映射关系：
map $upstream_addr $fallback_uri {
~192\.168\.10\.10:8080 "/fallback-pay.html";
~192\.168\.10\.11:8080 "/fallback-user.html";
default "/fallback-generic.html";
} - 在代理块中使用：
location / {
proxy_pass http://backend;
proxy_intercept_errors on;
error_page 502 504 = @dynamic_fallback;
}
location @dynamic_fallback {
internal;
root /usr/share/nginx/html;
try_files $fallback_uri =404;
}
利用后端响应头增强判断精度
如果后端能在出错时主动写入标识头（例如 X-Service-Name: search、X-Downgrade-Level: soft），Nginx 可通过 $upstream_http_x_service_name 等变量做更语义化的分流：
- 确保后端在 50x 响应中带 header：
HTTP/1.1 504 Gateway Timeout
X-Service-Name: search
X-Downgrade-Level: soft - 用 map 提取并映射：
map $upstream_http_x_service_name $fallback_page {
"search" "/search-offline.html";
"notify" "/notify-limited.html";
default "/system-busy.html";
} - 配合 internal location 返回对应页面，无需修改业务代码即可扩展策略
