nginx的error_page 404配置未生效，首要确认nginx是否实际加载该配置：检查是否误用apache、配置是否被include遗漏、宝塔是否点击“重载配置”；其次验证nginx -t语法正确性，并确保error_page路径为uri格式（如/404.html）、文件存在且权限为644、编码为utf-8无bom。
error_page 404 配置没生效？先确认 Nginx 是否真在读这个配置
宝塔里改了「网站设置 → 配置文件」里的 error_page 404 /404.html;，但访问不存在路径还是显示 “Welcome to nginx!”，大概率不是你写错了，而是 Nginx 根本没加载到这行。常见原因有三个：
– 当前站点实际用的是 Apache（右上角标着 Apache 就别碰 Nginx 配置）
– 配置文件被 include 到了其他地方，而你编辑的只是主模板或备份副本
– 宝塔保存后没点「重载配置」，Nginx 进程仍跑着旧内存配置
最直接验证方式：SSH 登录服务器，执行 nginx -t，如果提示语法错误或路径不存在，说明配置压根没过校验；如果显示 “test is successful”，再检查是否漏掉 location /404.html { } 这类隐含限制（某些精简版配置会禁止直接访问错误页）。
error_page 路径写错：/404.html 不等于 404.html
Nginx 的 error_page 指令中路径必须是 URI 形式，以 / 开头，代表从网站根目录起算。写成 error_page 404 404.html;（无斜杠）或 error_page 404 /www/wwwroot/site/404.html;（绝对路径）都会失效。
正确写法只有这一种：error_page 404 /404.html;
同时确保：
– 文件真实存在于网站根目录下（比如 /www/wwwroot/your-site/404.html）
– 文件权限为 644，属主是 www
– 文件编码是 UTF-8 无 BOM（用 Notepad++ 或 VS Code 确认，BOM 会导致空白页或乱码）
404 页面里资源全 404？检查链接路径类型
你写的 404.html 看似静态，但浏览器请求它时，当前 URL 是任意不存在路径（如 /abc/def/xyz）。这时页面内所有相对路径（比如 css/style.css）会被拼成 /abc/def/css/style.css，必然 404。
必须统一改成：
– 根相对路径：用 /css/style.css（前面带 /）
– 或者更稳妥：用完整协议+域名的绝对 URL（但注意跨域和 HTTPS 混合内容风险）
别在 404.html 里写 PHP、JS 动态生成路径的逻辑——纯静态页不走 PHP 解析，除非你额外配了 location ~ \.html$ { ... fastcgi_pass ... }，那反而容易引发循环或安全问题。
Windows 宝塔下 error_page 失效？重点查 Nginx 工作目录偏移
Windows 版宝塔有个隐藏坑：Nginx 进程启动时可能把工作目录（Prefix）错设成 C:\BtSoft\panel，而不是真正的安装路径 C:\BtSoft\nginx。结果就是：error_page 里的路径解析失败，Nginx 找不到 /404.html 对应的真实文件，直接 fallback 到默认页。
解决方法：
– 先执行 taskkill /f /im nginx.exe 清掉残留进程
– 再用命令行强制指定路径启动："C:/BtSoft/nginx/nginx.exe" -p "C:/BtSoft/nginx/" -c "C:/BtSoft/nginx/conf/nginx.conf" -t
– 如果 -t 报 temp 目录缺失，手动创建：mkdir C:\BtSoft\nginx\temp\client_body_temp 等三个子目录
– 最后用相同命令加 -s reload 启动
真正卡住人的往往不是配置语法，而是 Nginx 实际加载的是哪份配置、工作目录在哪、文件权限对不对——这些细节一错，error_page 就像没写一样。
