Nginx中需在server块配置error_page 404 /404.html并配location = /404.html { internal; root C:/phpEnv/www; }，确保路径以/开头、root显式指定、internal禁直访，且用curl -I验证返回真实404状态码。
phpEnv 是基于 Windows 的集成环境，底层用的是 Nginx + PHP-FPM，所以它没有 Apache 的 ErrorDocument 指令，必须用 Nginx 的 error_page 配置，且路径、作用域、internal 三者稍有错位就会返回 500 或直接显示默认错误页。
确认 phpEnv 使用的 Nginx 配置文件位置
phpEnv 默认把 Nginx 配置放在安装目录下的 nginx\conf\nginx.conf（例如 C:\phpEnv\nginx\conf\nginx.conf）。不要去改 conf\extra\ 下的子配置——phpEnv 启动时只加载主 nginx.conf，其他文件不被 include。
- 打开该
nginx.conf，找到http块或某个server块（通常只有一个server） - 确保没被注释掉的
error_page行存在，比如：error_page 404 /404.html; - 注意：等号前后必须有空格，路径必须以
/开头，否则 Nginx 会解析失败，启动报错或静默忽略
把 404 页面文件放对位置并配好 root
phpEnv 的 Nginx 默认 root 是 C:/phpEnv/www（Windows 路径），所以 /404.html 对应的真实路径是 C:/phpEnv/www/404.html。不能放错地方，也不能用相对路径。
- 把你的自定义
404.html直接丢进C:/phpEnv/www/目录（不是子目录） - 如果想用子目录（如
/error/404.html），就得同步改root或加location块——但 phpEnv 默认没配，强行加容易出错 - 页面里所有 CSS/JS/图片引用必须用绝对路径（如
/style.css）或 base64 内联，避免因 Nginx 不处理子路径静态资源而白屏
必须加 internal 并禁用外部直访
只写 error_page 404 /404.html; 是不够的。Nginx 会尝试用当前 server 的 root 去找这个文件，但如果用户手动访问 http://localhost/404.html，就暴露了错误页——这不符合规范，也容易被爬虫收录。
立即学习“PHP免费学习笔记（深入）”；
- 在
server块里补上这个location块：
location = /404.html {
internal;
root C:/phpEnv/www;
}
-
internal是关键：它禁止浏览器直接请求该 URI，只允许 Nginx 内部重定向时触发 -
root必须显式写出（哪怕和外层一样），否则 Nginx 可能拼错路径，返回 404 或 500 - 别漏掉等号：
location = /404.html是精确匹配，写成location /404.html会匹配所有含该字符串的路径，导致意外覆盖
验证是否真返回 404 状态码而非 200 或 302
很多人以为页面显示出来了就成功了，其实浏览器地址栏没变、内容对了，但状态码仍是 200 —— 这会让搜索引擎当成正常页面索引，API 客户端也收不到语义正确的响应。
- 用
curl -I http://localhost/nonexistent-path看响应头，第一行必须是HTTP/1.1 404 Not Found - 用浏览器开发者工具的 Network 面板刷新一个不存在的路径，检查 Status 列是不是
404 - 如果看到
302，说明你误用了header('Location: ...')；如果看到200，说明 Nginx 没生效，或者404.html文件本身被当成了普通页面返回（没走error_page流程）
最常被忽略的是 internal 和 root 的组合写法——少一个就可能让整个配置变成摆设。phpEnv 没有图形化配置界面，所有改动都靠手改 nginx.conf，改完必须运行 nginx -t 校验语法，再用 phpEnv 控制台重启 Nginx，缺一不可。
