Nginx 配置自定义 404 页面需满足三要素：开启错误拦截（如 try_files $uri $uri/ =404）、正确设置 error_page 与 location = /404.html（推荐 root + internal）、确保 404.html 文件存在且 Nginx 进程有读取权限。
Nginx 在 root 目录缺失（即请求的静态文件根本不存在于配置路径下）时，要返回友好的自定义 404 页面，关键不是“修复 root”，而是让 Nginx 主动接管这个 404，而不是透传或报错。它不依赖后端，纯靠网关层配置生效，核心就三件事：**拦截触发、定位页面、确保可读**。
必须开启错误拦截机制
仅写 error_page 404 /404.html 是无效的。Nginx 默认对静态文件未命中（如 try_files 失败或直接访问不存在路径）会直接返回默认 404，不会跳转到你写的页面——除非你明确告诉它“我来处理”。
对于纯静态服务（无 proxy_pass、无 fastcgi_pass），通常不需要额外开关；但如果你用了 try_files（SPA 部署常见），就得特别注意：
• 错误写法：try_files $uri $uri/ /index.html; → 所有路径都 fallback 到 index.html，真实 404 被掩盖
• 正确写法：try_files $uri $uri/ =404; 或更稳妥地按扩展名分流（如 JS/CSS/IMG 单独 location + =404）
正确声明 error_page 和专用 location
error_page 404 /404.html 中的 /404.html 是 URI 路径，不是磁盘路径。它最终指向哪个文件，取决于该作用域下的 root 或 alias。
推荐用 root 配合显式 location，并加 internal 防止用户直访：
• 在 server 块中写：error_page 404 /404.html;
• 紧接着加：
location = /404.html {<br> root /var/www/error-pages;<br> internal;<br>}
这样，/404.html 就实际读取 /var/www/error-pages/404.html。别用 alias 替代 root —— 对 = 匹配的 location，alias 容易因末尾斜杠问题导致路径错位。
确保错误页文件真实存在且权限正确
就算配置全对，如果 Nginx 工作进程读不到那个 HTML 文件，依然会返回空白或二次 404。
• 把你的 404.html 放到指定目录，例如：/var/www/error-pages/404.html
• 检查文件权限：chmod 644 /var/www/error-pages/404.html
• 检查目录权限：chmod 755 /var/www/error-pages（Nginx 用户需有执行权限进入目录）
• 确认 Nginx 用户（如 www-data 或 nginx）是文件属主：chown www-data:www-data /var/www/error-pages/404.html
• 可临时用 curl -I http://localhost/404.html 测试该路径是否能正常返回 200，排除基础访问问题。
