要统一返回美观友好的502/504自定义页面，必须同时满足四条件：正确配置error_page、开启proxy_intercept_errors、location精确匹配文件路径、页面文件≥512字节；还应使用=502/=504保留原始状态码。
要让 Nginx 在发生 502 Bad Gateway 或 504 Gateway Timeout 时，统一返回一个美观、友好的自定义页面（而非默认的简陋文本或浏览器兜底页），需同时满足四个硬性条件：正确配置 error_page、开启对应拦截开关、确保静态资源路径可访问、页面文件大小 ≥ 512 字节。缺一不可。
1. 在 http 块中配置全局 error_page
编辑 /etc/nginx/nginx.conf，在 http { ... } 区域内添加：
error_page 502 504 /error/50x.html;
这表示所有 server 块下触发 502 或 504 时，都跳转到该路径。注意：
- 路径 /error/50x.html 是 URI 路径，不是磁盘路径；
- 实际文件位置由后续 location 中的 root 或 alias 决定。
2. 必须开启 proxy_intercept_errors
502/504 是反向代理层错误（上游服务无响应或超时），Nginx 默认不接管这类响应，必须显式启用拦截：
proxy_intercept_errors on;
该指令应放在 http 块顶层（全局生效），或至少覆盖所有使用 proxy_pass 的 server 块。若同时用 FastCGI（如 PHP），可额外加 fastcgi_intercept_errors on;，但对 502/504 无效。
3. 配置 location 确保页面可访问
在 http 块内补充 location 块：
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
location = /error/50x.html {
internal;
root /usr/share/nginx/html;
}
说明：
- internal 防止用户直接请求 /error/50x.html 绕过错误逻辑；
- root /usr/share/nginx/html 表示实际文件位于 /usr/share/nginx/html/error/50x.html；
- 若用 alias，写法不同：alias /usr/share/nginx/html/error/;（末尾斜杠不能少）。
4. 页面文件需满足两个关键限制
即使配置全对，页面仍不显示，大概率卡在这两点：
-
路径必须精确匹配：比如
root /usr/share/nginx/html;，那文件就必须是/usr/share/nginx/html/error/50x.html，不能放错目录； -
文件体积 ≥ 512 字节：IE 和部分旧客户端强制要求，否则直接显示浏览器内置错误页。可用
wc -c /path/to/50x.html检查，不够就加空格、注释或嵌入 base64 图片补足。
建议将 CSS 内联、图片转为 data URI，避免额外资源加载失败导致样式丢失。
5. 可选：保留原始状态码（推荐）
默认 error_page 502 /error/50x.html 会返回 200 状态码，掩盖真实问题。前端重试或监控告警依赖真实状态码，应改写为：
error_page 502 =502 /error/50x.html; error_page 504 =504 /error/50x.html;
这样响应头中仍是 502 Bad Gateway，内容却是你设计的友好 HTML。
配置完执行 nginx -t 测试语法，再 nginx -s reload 生效。验证方式：临时停掉上游服务（如关掉后端 Node.js 或 Tomcat），然后访问接口，观察是否显示你的定制页面。
