phpEnv 的 Nginx 默认不支持开箱即用自定义错误页，需手动在 vhost 配置中添加 error_page、internal location 及绝对路径 root，并确保 mime.types 正确包含且无路径尾部斜杠，否则 404.html 将空白或触发下载。
phpEnv 自带的 Nginx 不支持开箱即用的自定义错误页，必须手动修改其内置 Nginx 配置并确保静态资源路径可访问——否则你放进去的 404.html 会因 MIME 类型缺失或路径错乱而显示为空白或下载弹窗。
确认 phpEnv 的 Nginx 配置位置和生效范围
phpEnv 默认把 Nginx 配置放在 %PHPENV_HOME%\nginx\conf\nginx.conf（Windows 下常见路径如 C:\phpEnv\nginx\conf\nginx.conf）。它通常只在 http 块里包含一个 include conf/vhost/*.conf，而你的站点配置实际在 vhost\ 子目录下。所以：
- 不要直接改
nginx.conf顶层的http块，除非你想全局生效； - 优先编辑对应站点的
vhost\your-site.conf，在server块内加error_page； - 如果多个站点共用一套错误页，再考虑在
http块统一配root和error_page。
写对 error_page + location + internal 三件套
只写 error_page 404 /404.html; 是不够的，Nginx 会尝试用当前 location 的 root 去找文件，而默认 root 往往指向 www/ 目录，不是你放错误页的地方。常见错误现象：页面空白、控制台报 net::ERR_ABORTED 404、CSS 不加载。
正确做法是显式指定错误页所在位置，并用 internal 防止用户直连：
立即学习“PHP免费学习笔记（深入）”；
error_page 404 /err/404.html;
error_page 502 /err/502.html;
location = /err/404.html {
internal;
root C:/phpEnv/nginx/html;
}
location = /err/502.html {
internal;
root C:/phpEnv/nginx/html;
}
-
root必须是磁盘绝对路径（Windows 下用正斜杠或双反斜杠），且末尾不带/； -
/err/404.html中的/err/是 URI 前缀，和磁盘路径无关，全靠root拼接； - 如果你把文件放在
C:\phpEnv\nginx\html\err\404.html，那root就设为C:/phpEnv/nginx/html； - 缺
internal会导致用户访问http://localhost/err/404.html直出页面，既不安全又可能绕过日志。
让 CSS/图片正常加载的关键：MIME 类型和相对路径
phpEnv 自带的 Nginx 默认没开 include mime.types;，或者 mime.types 文件缺失/路径错，结果就是浏览器把 .css 当成 text/plain，拒绝执行样式。错误现象：HTML 结构出来，但无样式、无图片、文字堆在一起。
检查并确保以下两点：
- 在
http块顶部确认有：include mime.types;，且mime.types文件真实存在（路径通常是C:\phpEnv\nginx\conf\mime.types）； - 错误页里的资源全部用相对路径，例如
<link rel="stylesheet" href="style.css">，然后把style.css放在同级目录（如C:\phpEnv\nginx\html\err\style.css）； - 避免使用
../跳出/err/目录，Nginx 不会为你解析上级路径——internallocation 的 root 是硬绑定的。
验证前必须跑通两个命令
改完配置别急着重启，先验证语法和路径是否真能命中：
- 打开命令行，cd 到
C:\phpEnv\nginx，运行：nginx -t—— 必须输出nginx: configuration file C:\phpEnv\nginx\conf\nginx.conf test is successful； - 如果报
open() "/xxx/404.html" failed (2: No such file)，说明root+ URI 拼出来的磁盘路径错了，回去核对； - 语法通过后，用：
nginx -s reload（若提示 access denied，请右键“以管理员身份运行”命令行）； - 测试时用 Incognito 窗口，避免缓存干扰；触发 404 最简单方式是访问
http://localhost/___nonexistent。
最容易被忽略的是 mime.types 缺失和 root 路径末尾多了一个 /——前者导致样式失效，后者会让 Nginx 拼出 C:/phpEnv/nginx/html//err/404.html 这种非法路径。
