Nginx统一接管后端错误页需同时配置proxy_intercept_errors on与error_page指令，且须在同一location作用域；错误页文件须真实存在并用internal location声明；后端响应体不能为空，否则拦截失效。
要让 Nginx 统一接管后端返回的 404 或 500 错误页面，关键不是只写 proxy_intercept_errors on;，而是必须和 error_page 成对配置，并确保路径可访问、响应体非空。它本身不生成页面，只是打开“拦截开关”。
必须在同一作用域配对启用
仅开启拦截指令无效，必须在同一个 location（或其父级 server）中同时存在：
proxy_intercept_errors on;-
error_page 404 /404.html;或error_page 500 /50x.html;等明确状态码与目标路径
例如，在代理接口的 location 块里这样写：
location /api/ {
proxy_pass http://backend;
proxy_intercept_errors on;
error_page 404 /404.html;
error_page 500 /50x.html;
}
确保错误页文件真实存在且路径正确
Nginx 不会自动查找或生成错误页，你得提前准备好 HTML 文件，并用 location = /xxx.html 显式声明它的位置：
- 把
/404.html放在/usr/share/nginx/html/（默认 root）下 - 添加对应 location 块，指定 root 并设为 internal（防直接访问）：
location = /404.html {
internal;
root /usr/share/nginx/html;
}
若放在其他目录（如 /var/www/error-pages/），则需同步修改 root 路径。
注意后端响应体不能为空
Nginx 默认忽略空 body 的错误响应——比如某些框架返回 404 但没写响应体，proxy_intercept_errors 就不会触发。解决办法有二：
- 让后端补全响应体（推荐，符合 HTTP 规范）
- 临时关闭缓冲：
proxy_buffering off;（慎用，影响性能）
只要响应头里有合法状态码（如 HTTP/1.1 404 Not Found）且 body 非空，Nginx 才会识别并拦截。
可选：统一降级或重定向不同错误
不必所有错误都返回同一页面。你可以按故障类型区分处理：
-
error_page 404 /404.html;—— 页面不存在 -
error_page 500 /500-internal.html;—— 后端程序崩溃 -
error_page 502 503 504 /maintenance.html;—— 网关或上游不可用 - 或者跳转首页：
error_page 404 =302 /;
每种页面可嵌入文案、联系方式或前端自动重试逻辑，提升用户感知。
