宝塔面板中可通过图形化设置、手动修改Nginx配置或Apache的ErrorDocument指令实现自定义404/502页面：一、网站设置中启用自定义错误页并填写HTML路径；二、Nginx server块内添加error_page指令；三、Apache通过.htaccess配置ErrorDocument；四、通过访问不存在路径、停用后端及curl命令验证生效。
如果您在宝塔面板中部署网站后，希望用户访问不存在的资源时显示自定义404页面，或后端服务异常时返回定制化的502提示页，需手动配置Nginx或Apache的错误页面响应规则。以下是实现该目标的具体步骤：
一、通过网站设置启用自定义错误页
宝塔面板为每个网站提供了图形化入口来绑定错误页面，适用于Nginx与Apache环境，无需直接编辑配置文件。该方式优先级高且不易被后续面板操作覆盖。
1、登录宝塔面板，在左侧菜单点击网站，找到目标站点，点击右侧设置按钮。
2、在弹出窗口中切换至配置文件选项卡，向下滚动至自定义错误页区域。
3、勾选启用自定义错误页，在404和502输入框中分别填写对应HTML文件的相对路径（如：/404.html 或 /err/502.html）。
4、确保所填路径的HTML文件已上传至网站根目录或指定子目录中，且文件权限为644。
二、手动修改Nginx配置文件添加error_page指令
当图形界面不可用或需精细控制响应行为（如携带特定Header、重定向逻辑）时，可直接编辑Nginx配置。此方法适用于高级定制需求，但需注意备份原配置。
1、在网站设置中切换至配置文件选项卡，定位到server { ... }区块内部。
2、在location / { ... }块之外、server块之内，插入以下两行：
error_page 404 /404.html;
error_page 502 /502.html;
3、确认文件路径与实际存放位置一致；若使用绝对路径，需以/开头并指向网站根目录下的文件。
4、点击右上角保存，随后点击重载配置使Nginx生效。
三、为Apache环境配置ErrorDocument指令
若目标网站使用Apache作为Web服务器，需通过.htaccess或虚拟主机配置启用错误文档映射。.htaccess方式更灵活，适合单站独立管理。
1、使用宝塔文件管理器进入网站根目录，检查是否存在.htaccess文件；若无，新建一个空白文本文件并命名为该名称。
2、在文件中添加以下两行内容：
ErrorDocument 404 "/404.html"
ErrorDocument 502 "/502.html"
3、确保双引号内路径为相对于网站根目录的URL路径，且目标HTML文件已存在。
4、返回网站设置，在配置文件选项卡中确认Apache已启用AllowOverride All，否则.htaccess不生效。
四、验证自定义页面是否生效
配置完成后需主动触发错误状态码，排除缓存干扰并确认响应头与内容正确返回。此步骤可避免因浏览器或CDN缓存导致误判。
1、在浏览器地址栏输入一个肯定不存在的路径（如：/nonexistent-page-abc123），观察是否加载自定义404页面。
2、临时停用网站后端（如关闭PHP-FPM或停止反向代理目标服务），刷新网页，确认返回的是自定义502页面而非默认Nginx/Apache错误页。
3、使用curl命令验证HTTP状态码及响应头：curl -I https://yourdomain.com/nonexistent，应返回HTTP/2 404或HTTP/2 502。
