宝塔面板配置自定义 404 和 502 错误页面主要通过网站设置中的“错误页面”功能或直接修改 Nginx/Apache 配置文件实现。适用场景为需要统一品牌视觉或隐藏服务器详细信息的站点，风险边界在于配置错误可能导致网站无法访问，修改前务必备份配置文件。

命令速用版

若通过配置文件直接修改，Nginx 环境下可在配置文件中添加错误页面指令，以下代码片段可直接参考使用。

error_page 404 /404.html;
error_page 502 /502.html;

location = /404.html {
    root /www/wwwroot/你的域名;
    internal;
}

location = /502.html {
    root /www/wwwroot/你的域名;
    internal;
}

Apache 环境下可在.htaccess 或配置文件中添加 ErrorDocument 指令，修改后需重启 Apache 服务。

ErrorDocument 404 /404.html
ErrorDocument 502 /502.html

为什么会这样

自定义错误页面的本质是 Web 服务器在捕获特定 HTTP 状态码时，将请求内部重定向到指定的静态文件。404 错误表示请求的资源在服务器上不存在，502 错误表示网关或代理服务器从上游服务器收到无效响应，通常是因为 PHP-FPM 崩溃或后端服务超时。配置自定义页面不会修复导致 502 的根本故障，仅用于改善用户看到错误时的体验。

分步处理

配置过程分为准备文件、面板设置或修改配置、重载服务三个步骤，每一步都需要确认文件路径和权限正确。

第一步：准备错误页面文件

在本地设计好 404.html 和 502.html 文件，确保文件内不包含动态脚本依赖，通过 FTP 或文件管理器上传至网站根目录，例如/www/wwwroot/你的域名/。

第二步：通过面板配置（推荐）

登录宝塔面板，点击“网站”，找到目标站点点击“设置”，在左侧菜单寻找“错误页面”选项，上传或选择已存在的 html 文件关联 404 和 502 状态码。若面板版本未直接提供 502 配置入口，则选择“配置文件”手动添加上述 Nginx/Apache 指令。

第三步：应用配置

修改完成后，点击面板上的“保存”或“重载配置”按钮，Nginx 执行 reload，Apache 执行 restart，确保新配置生效。

怎么验证是否生效

验证需要通过浏览器或命令行工具触发对应的错误状态码，观察返回内容是否为自定义页面。

验证 404 页面

在浏览器访问网站下一个不存在的 URL，例如 http://你的域名/test_404_page.html，检查页面内容是否为你上传的 404.html 内容，同时检查浏览器开发者工具网络标签确认状态码为 404。

验证 502 页面

502 验证较复杂，可临时停止 PHP-FPM 服务或修改配置文件指向错误的端口触发错误，使用 curl 命令查看返回头和内容。

curl -I http://你的域名/某个动态页面

若返回状态码为 502 且 body 内容为自定义 HTML，则配置生效，验证完成后记得恢复后端服务。

常见坑

配置过程中容易遇到文件路径错误、权限不足或缓存导致页面不更新的问题，需重点排查。

• 文件路径错误：配置中的 root 路径必须与实际文件上传路径一致，Nginx 的 internal 指令限制外部直接访问错误页文件，必须通过错误触发内部跳转。
• 502 根本原因未解决：自定义 502 页面只是“遮丑”，不能解决 PHP-FPM 挂掉或后端超时的实际问题，生产环境需配合日志排查后端故障。
• 浏览器缓存：浏览器可能缓存了默认的错误页面，验证时建议使用无痕模式或清除缓存，避免误判配置未生效。
• 权限问题：确保 html 文件权限为 644，所属用户为 www 或运行 Web 服务的用户，否则服务器可能因无权读取而返回 403 错误。

常见问题

自定义 502 页面后为什么还是显示默认错误？

通常是配置文件未重载或路径配置错误，检查 Nginx 配置中 error_page 指向的文件路径是否正确，并执行 nginx -s reload 确保配置加载。

配置错误页面会影响 SEO 吗？

正确配置 404 页面不会影响 SEO，但需确保返回的 HTTP 状态码仍然是 404 而不是 200，否则搜索引擎会认为页面存在而导致收录问题。

宝塔面板找不到 502 配置入口怎么办？

部分宝塔版本界面未直接暴露 502 配置项，此时应点击网站设置中的“配置文件”，手动在 server 块中添加 error_page 502 指令。

参考来源

• 宝塔面板官方网站，页面标题：宝塔面板 - 简单好用的服务器运维面板，URL：https://www.bt.cn/
• Nginx 官方文档，页面标题：Module ngx_http_core_module，URL：http://nginx.org/en/docs/http/ngx_http_core_module.html#error_page