error_page是Nginx自定义错误页的核心指令，通过将指定状态码重定向到内部URI实现错误响应处理；需配合root/alias或internal location确保URI可访问，并支持状态码保留、变量透传及map条件分发。
在 Nginx 中，
指令是实现错误页面自定义的核心机制。它不改变真实响应状态码（除非配合
或
），而是将特定 HTTP 状态码的响应“重定向”到一个内部 URI，由该 URI 对应的 location 处理并返回内容——这正是实现美观、统一、带业务逻辑的错误页的关键。
基础语法与常见写法
必须写在作用域内（如
、
或
块中），基本格式为：
error_page 状态码... URI;
例如：
→ 所有 404 响应都交由根路径下的
返回
→ 多个状态码共用一个页面
→ 显式保留 403 状态码（等号后为新状态码）
→ 把 404 改成 200 响应（慎用，SEO 不友好）
让错误页真正“生效”的关键配置
仅写
不够，还需确保目标 URI 能被正确服务。常见方式有两种：
Nginx
在宝塔面板中轻松管理Nginx高性能Web服务器。提供可视化配置反向代理、负载均衡、SSL证书及HTTP缓存功能，一键优化高并发性能，助您高效搭建稳定、快速的网站运行环境。
下载
静态文件方式
：URI 指向磁盘上真实存在的 HTML 文件，需配合
或
定义路径映射
示例：
→ 实际读取
内部 location 处理方式
（更灵活）：用
拦截，可加 header、日志、甚至代理到后端
示例：
表示仅内部访问，禁止用户直接请求
传递原始请求信息（提升用户体验）
默认情况下，错误页无法获取原请求 URL、参数或方法。可通过
、
、
等变量，在 error_page 后接参数方式透传：
然后在
中用 JS 读取 URL 参数，动态展示“您访问的页面
xxx
不存在”
注意：若使用
location，变量仍可用；但外部跳转时需确保参数安全（避免 XSS）
高级用法：按条件返回不同错误页
利用
指令 + 变量，可实现基于 User-Agent、来源域名或路径前缀的差异化错误页：
先定义映射：
再使用：
这样 API 调用（curl）看到的是纯文本 404，浏览器用户看到的是带样式的 HTML 页面
不复杂但容易忽略：务必检查文件权限、Nginx 用户能否读取错误页文件，以及是否启用
（默认关闭，无需开启，除非你真需要多层 error_page 嵌套）。
error_pagereturnrewriteerror_pagehttpserverlocationerror_page 404 /404.html;/404.htmlerror_page 500 502 503 504 /5xx.html;error_page 403 =403 /forbidden.html;error_page 404 =200 /notfound.html;error_pagerootaliasroot /var/www/html;error_page 404 /404.html;/var/www/html/404.htmllocation = /404.htmlerror_page 404 /404.html;location = /404.html {internal;add_header Content-Type text/html; }$request_uri$host$schemeerror_page 404 /error.html?uri=$request_uri&host=$host;/error.htmlinternalmapmap $http_user_agent $error_page_type {~*curl|wget "cli";default "web";}error_page 404 /errors/404_$error_page_type.html;recursive_error_pages off;