宝塔面板显示“Internal Server Error”时,应优先执行bt 16修复;若失败,则依次尝试SSH修复、强制重置pyenv、禁用SSL校验或Windows下CMD执行bt 16/17。

如果您尝试访问宝塔面板时页面显示“Internal Server Error”或“系统内部错误”,通常表明面板后端服务运行异常,核心模块加载失败或Python环境损坏。以下是通过宝塔面板终端执行 bt 16 修复面板的具体操作路径与替代方案:
一、通过宝塔面板内置终端执行 bt 16 修复
此方法适用于面板前端仍可部分加载、能进入终端界面的情形,直接调用官方修复脚本重建运行环境。
1、使用浏览器登录宝塔面板(若能打开登录页)。
2、在左侧菜单栏点击【终端】,进入面板内置Web终端。
3、在终端输入命令并回车:bt 16。
4、等待终端输出“正在修复面板…”及后续日志,直至出现“修复完成”提示。
5、修复结束后,在终端中输入 bt 1 重启面板服务。
6、刷新浏览器页面,验证是否恢复正常访问。
二、通过SSH远程终端执行 bt 16 修复
当面板完全无法加载、登录页即报错时,必须借助服务器SSH连接执行修复命令,绕过前端限制直接操作底层服务。
1、使用SSH工具(如PuTTY、FinalShell或系统Terminal)连接服务器。
2、输入您的服务器账号密码或密钥完成登录。
3、在SSH终端中输入命令并回车:bt 16。
4、观察输出日志,确认是否出现“修复成功”或“Panel repair completed”字样。
5、若提示“请重启面板”,则立即执行:bt 1。
6、执行完成后,使用浏览器重新访问宝塔面板地址(如 http://服务器IP:8888)。
三、执行 bt 16 失败时的强制环境重置
当执行 bt 16 后报错“ModuleNotFoundError”、“No module named 'panelSite'”或“pyenv not found”,说明Python虚拟环境已损毁,需手动备份并重建pyenv目录。
1、在SSH终端中执行命令备份当前pyenv:mv /www/server/panel/pyenv /www/backup/pyenv_backup。
2、执行更新脚本以重新下载并初始化环境:curl http://download.bt.cn/install/update_panel.sh | bash。
3、等待脚本自动完成下载、解压与环境部署。
4、更新完毕后,再次执行:bt 16。
5、修复成功后,执行:bt 1 启动服务。
四、证书校验冲突导致 bt 16 卡住或报错
部分CentOS 7系统因wget/curl与OpenSSL版本不兼容,会在执行bt 16时因SSL证书校验失败中断流程,需临时禁用证书检查机制。
1、在SSH终端中执行备份命令:\cp -rp /etc/wgetrc /www/backup/wgetrc_backup。
2、向配置文件追加跳过证书检测指令:echo "check_certificate = off" >> /etc/wgetrc。
3、执行修复命令:bt 16。
4、若修复完成,建议后续恢复证书校验以保障安全,可执行:sed -i '/check_certificate/d' /etc/wgetrc。
5、最后执行:bt 1 重启服务。
五、Windows系统服务器专用修复路径
Windows版宝塔面板不支持Web终端,所有修复操作必须通过系统CMD或PowerShell完成,且命令行为一致但入口不同。
1、以管理员身份运行CMD或PowerShell。
2、切换至宝塔安装目录(默认为:cd C:\BtSoft\panel)。
3、执行面板控制命令:bt,随后按提示输入数字 16。
4、若16号选项无响应或报错,尝试选择 17 进行强制升级。
5、修复或升级完成后,执行:bt 1 启动服务。
6、打开浏览器访问面板地址,确认“Internal Server Error”是否消失。








