需手动修改Nginx配置启用自定义502页面：一、在网站根目录创建并配置502.html；二、在宝塔面板配置文件中添加error_page 502 /502.html和location = /502.html { internal; }；三、或直接编辑站点conf文件并重载Nginx；四、通过停止PHP服务模拟502验证效果。
如果您在使用宝塔面板托管网站时，希望用户访问出现502错误时显示自定义页面而非默认的Nginx 502提示，则需手动修改网站对应的Nginx配置文件并启用自定义错误页功能。以下是具体操作步骤：
一、准备自定义502页面文件
自定义错误页需为静态HTML文件，建议存放于网站根目录下便于Nginx直接读取。该文件应独立存在且无需后端解析，确保在后端服务宕机（导致502）时仍可被Nginx正常返回。
1、登录服务器，进入目标网站根目录，例如 /www/wwwroot/example.com/。
2、使用命令创建502.html文件：touch 502.html。
3、编辑该文件，写入自定义HTML内容，例如：<h1>服务暂时不可用</h1><p>我们正在努力恢复，请稍后再试。</p>。
4、确认文件权限可被Nginx读取：chmod 644 502.html。
二、在宝塔面板中启用自定义错误页配置
Nginx原生支持error_page指令重定向特定HTTP状态码到本地静态资源，但宝塔默认不开启此功能，需手动注入配置片段，且须避免被面板自动覆盖。
1、进入宝塔面板，点击左侧【网站】，找到对应站点，点击【设置】。
2、切换到【配置文件】选项卡，在server块内、location / { ... } 块上方空白处插入以下代码：
error_page 502 /502.html;
3、在server块末尾（即}之前）添加以下location块以允许直接访问该错误页：
location = /502.html { internal; }
4、点击右上角【保存】按钮，使配置生效。
三、通过Nginx配置文件直接修改
若面板配置保存后未生效，或需确保配置持久化不被后续面板更新重置，可绕过面板界面，直接编辑Nginx站点配置文件，该方式对高级用户更可控。
1、执行命令打开对应站点配置文件：nano /www/server/panel/vhost/nginx/example.com.conf（将example.com替换为实际域名）。
2、在server { } 内任意位置（推荐位于root指令之后、第一个location之前）添加：
error_page 502 /502.html;
3、在同一server块内追加以下location配置，防止外部直接请求触发内部重定向失败：
location /502.html { internal; }
4、保存退出后，执行：nginx -t 验证语法，再执行：nginx -s reload 重载配置。
四、验证502页面是否生效
配置完成后需模拟502状态以确认页面正确返回，而非仅检查文件是否存在。因502本质是上游服务无响应，需临时中断后端服务来触发。
1、进入网站【设置】→【PHP版本】，点击当前运行的PHP版本右侧【停止】按钮（适用于PHP站点）。
2、在浏览器中访问该网站任意URL，观察是否返回您编写的502.html内容而非Nginx默认502页。
3、若仍显示默认页，检查Nginx错误日志：tail -f /www/wwwlogs/example.com.error.log，确认是否有“open() "/www/wwwroot/example.com/502.html" failed”类报错。
