Nginx 配置文件中 error_page 怎么优雅地重定向到自定义 404 页面-Nginx-PHP中文网

要让nginx优雅返回自定义404页面，关键在于error_page触发内部重定向而非跳转：需在server块中按序配置error_page 404 /404.html;、location = /404.html { internal; root /usr/share/nginx/html; }，并确保文件存在且权限正确；同时避免作用域错位、反向代理漏开proxy_intercept_errors、静态资源路径错误等问题。

nginx 配置文件中 error_page 怎么优雅地重定向到自定义 404 页面

要让 Nginx 优雅地返回自定义 404 页面，关键不是“跳转”，而是用 error_page 触发内部重定向，并确保页面能被正确、安全地响应——地址栏不变、状态码仍是 404、用户看到的是友好内容。

必须写对的三行核心配置

在 server 块内按顺序配置：

error_page 404 /404.html; —— 告诉 Nginx：遇到 404 就内部转向 URI /404.html
location = /404.html { internal; root /usr/share/nginx/html; } —— 明确告诉 Nginx 怎么响应这个 URI：只允许内部访问，文件从 /usr/share/nginx/html/404.html 读取
确认 /usr/share/nginx/html/404.html 文件真实存在，且 Nginx 进程有读取权限（如 chmod 644）

避免常见失效原因

很多配置看似写了却没生效，往往卡在这几个地方：

Pandas 配置文件报告生成器

使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载

作用域错位：把 error_page 404 ... 写在某个 location /api { } 里，它就只对 /api 下的 404 生效；主站其他路径仍走默认页
反向代理漏开关：后端（如 Node.js、Django）返回 404 时，Nginx 默认透传，不触发本地 error_page。必须在同级 location 中加 proxy_intercept_errors on;
静态资源路径错乱：页面里引用 css/style.css 是相对路径，浏览器会按原 URL（比如 /missing/path）去解析，导致样式丢失。建议用绝对路径（/css/style.css）或在加 <base href="/">

让页面真正“友好”而不是“裸露”

一个可用的 404 页面不只是 HTML，还需注意细节：

页面中所有资源（JS、CSS、图片）都放在 Nginx 能直接服务的路径下，比如和 404.html 同级或统一放 /static/ 目录
不要省略 internal; —— 否则用户可直接访问 https://yoursite.com/404.html，暴露错误结构，也影响 SEO
如果多个错误共用一个模板（如 404/500 都用 /error.html），可用 error_page 404 /error.html?code=404;，再配合前端 JS 读参渲染不同提示