nginx 配置错误页面需用 error_page 指令映射状态码到内部路径，并满足三条件：启用 intercept_errors、定义带 internal 的 location 块、确保文件存在且 ≥512 字节。

在 Linux 的 Nginx 中配置不同状态码的错误页面，核心是用 error_page 指令把状态码映射到可访问的内部路径，并确保 Nginx 能真正“接管”这些错误响应。光写一行 error_page 404 /404.html 很可能无效，必须同时满足几个硬性条件。

基本配置：绑定状态码与静态页面

最常用方式是在 server 块中声明：

• error_page 404 /404.html; —— 所有 404 请求返回根目录下的 404.html
• error_page 500 502 503 504 /50x.html; —— 多个后端错误共用一个兜底页
• error_page 403 =403 /forbidden.html; —— 显式保留原始 403 状态码（对前端识别很重要）

关键配套：让 error_page 真正生效

以下三点缺一不可，否则你看到的仍是默认白页或浏览器兜底页：

linux-performance-analyzer

Linux 性能分析与调优专家，覆盖 CPU、内存、磁盘 I/O、网络、内核参数、编译优化、容器/K8s。适用场景：系统卡顿/高负载、内存不足/OOM/Swap 高、CPU 异常/iowait 高。

下载

• 开启拦截开关：Nginx 默认不拦截后端返回的错误码
  → 反向代理（如 Node.js、Tomcat）：在对应 location 块加 proxy_intercept_errors on;
  → PHP-FPM：在 http 或 server 块加 fastcgi_intercept_errors on;
• 显式定义 location = /xxx.html：
  必须单独配 location = /404.html { root /usr/share/nginx/html; internal; }
  等号不能少，root 是目录，Nginx 自动拼成完整路径；internal 防止用户直接访问该地址
• 文件存在且合规：
  确认 /usr/share/nginx/html/404.html 存在、可读（chmod 644），且大小 ≥ 512 字节（IE 和部分旧客户端强制要求）

进阶用法：跳转、JSON、动态响应

不只是返回 HTML，还能灵活适配不同场景：

• 跳转到首页或外部地址：
  error_page 404 = @tohome;
location @tohome { return 302 /; } 或 return 302 https://example.com/;
• API 返回 JSON 错误体：
  error_page 429 = @rate_limited;
location @rate_limited { return 429 '{"code":429,"message":"Too many requests"}'; add_header Content-Type "application/json"; }
• 按地区或设备差异化页面：结合 map 指令和变量，例如用 $geoip_country_code 动态切换 root 路径

作用域与优先级注意点

配置位置影响生效范围：

• 写在 http 块：全局默认，所有 server 继承
• 写在 server 块：仅对该域名生效，推荐日常使用
• 写在 location 块：只对匹配路径内的错误生效（如 location /api/ 内的 404）
• 不要写在 if 块里——Nginx 不支持，会静默忽略