宝塔面板修改404页面需按Web服务器类型配置:Nginx在网站配置文件中设置error_page 404 /404.html;Apache在伪静态中添加ErrorDocument 404 /404.html,且必须重载配置并用真实不存在路径验证。

宝塔面板里改404页面,本质就是改 Nginx/Apache 的错误页配置,不是只换一个文件就行
直接替换网站根目录下的 404.html 文件没用——除非你已经明确告诉 Web 服务器“这个文件就是我的 404 页面”。宝塔只是可视化界面,底层仍是 Nginx 或 Apache,它们默认不会自动识别根目录的 404.html,必须显式声明。
确认当前网站使用的 Web 服务器类型再操作
进宝塔 → 网站 → 找到目标站点 → 看右上角标识是 Nginx 还是 Apache。两者配置位置和语法完全不同,混用会导致 404 不生效甚至整站 500:
- 如果是
Nginx:配置在「网站设置」→「配置文件」里,找error_page 404行,改成error_page 404 /404.html;(路径以/开头,表示网站根目录下) - 如果是
Apache:进「网站设置」→「伪静态」标签页,在框内末尾追加一行:ErrorDocument 404 /404.html - 别漏掉分号(Nginx)或换行(Apache),也别写成绝对路径如
/www/wwwroot/xxx/404.html——Web 服务器不认这种写法
自定义 404.html 文件要避开几个硬坑
你放的 404.html 看似静态,但实际加载时受上下文影响极大:
- 所有 CSS/JS/图片链接必须用相对路径(如
./css/style.css)或根相对路径(如/css/style.css),不能用绝对 URL 或带域名的链接,否则 404 页面打开时资源 404 连环套 - 别在
404.html里写服务端代码(如)——纯静态页面不解析 PHP,除非你额外配了 PHP 解析规则 - 文件编码保存为 UTF-8 无 BOM,否则某些 Nginx 版本会返回乱码或空白页
- 上传后检查文件权限:确保是
644,且属主是www(可用宝塔文件管理器右键「权限」修改)
验证是否真生效,别信“保存就完事”
改完配置必须重载服务,且要用真实不存在的路径测试:
- 点宝塔「网站设置」→「重载配置」(不是「保存」);Nginx 用户还可执行
nginx -t && systemctl reload nginx双校验 - 浏览器访问一个明显不存在的地址,比如
https://yourdomain.com/this-page-does-not-exist-abc123 - 看浏览器地址栏是否仍显示该路径(说明是内部跳转,正常),而不是跳转到首页或报 500;同时用 F12 → Network 标签,确认响应状态码确实是
404,且响应内容是你写的404.html - 如果看到“Welcome to Nginx”,说明
error_page没生效,大概率是配置语法错或没重载
最常被忽略的是:改了 Nginx 配置却没点「重载配置」,或者把 error_page 写在了 server 块之外、location 块之内——这两个位置都不起作用。配置逻辑比看起来更严格。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










