上一篇
登录服务器执行宝塔工具箱修复选项或官方修复脚本,依次检查磁盘空间、重启面板服务、清理缓存、修复Python环境、放行端口并刷新浏览器即可恢复。
检查并清理磁盘空间
宝塔面板白屏很多时候由磁盘空间写满引起,登录服务器后先执行以下命令查看磁盘使用情况：
df-h
重点查看根分区 、/www 和 /www/server 的使用率，如果使用率接近或达到100%，面板无法写入缓存和日志就会白屏，执行：
du-sh/www/*|sort-rh|head-n20
找出占用空间较大的目录,常见可清理位置包括网站日志、面板日志、临时文件和备份压缩包，面板日志目录为 /www/server/panel/logs/，可使用：
rm-rf/www/server/panel/logs/*
清理系统临时文件：
rm-rf/tmp/*/var/tmp/*
还可在宝塔工具箱执行 bt，选择清理系统缓存选项，自动释放部分空间，清理完成后再次执行 df -h 确认空间恢复。
重启宝塔面板服务
面板白屏也可能是面板进程卡死或内存不足导致,执行 bt 命令打开宝塔工具箱，选择“重启面板服务”，如果看不到菜单，直接执行：
systemctlrestartbt
或：
/etc/init.d/btrestart
部分系统使用：
systemctlrestartbt-panel
重启后等待10秒,再访问面板地址，如果面板仍然白屏，可以执行：
bt2
查看面板运行日志,寻找报错信息，常见报错包括端口占用、Python模块缺失、数据库写入失败等，根据日志提示继续处理。
清理面板缓存和浏览器缓存
面板自身缓存异常也会导致白屏,服务器端可删除面板的临时编译缓存，目录一般包括：
rm-rf/www/server/panel/pyenv/__pycache__ rm-rf/www/server/panel/class/__pycache__
这些缓存文件会在下次运行时自动重建,浏览器端缓存也需要处理，使用浏览器无痕窗口访问面板，或按 Ctrl + F5 强制刷新，如果之前访问过旧地址或旧端口，需要确认当前访问的面板地址、端口和安全入口是否正确，可执行：
bt7
查看完整面板地址。
使用官方修复脚本升级或修复面板
宝塔官方提供面板修复脚本,可自动修复损坏文件，SSH执行：
curl-sSOhttps://download.bt.cn/install/update_panel.sh&&bashupdate_panel.sh
部分地区网络访问 download.bt.cn 异常时，可先执行：
curl-sSOhttp://download.bt.cn/install/update_panel.sh&&bashupdate_panel.sh
脚本会自动下载最新面板文件并覆盖安装,同时保留现有网站、数据库和FTP数据，执行完成后脚本会提示修复结果，如果提示依赖错误，可继续执行下面的Python环境修复。
修复Python运行环境
宝塔面板依赖Python环境,Python模块冲突或缺失会导致面板无法加载，进入宝塔面板安装目录：
cd/www/server/panel
执行官方Python环境修复脚本：
curl-sSOhttps://download.bt.cn/install/install_soft.sh&&bashinstall_soft.sh0
或执行：
bash/www/server/panel/install/install_soft.sh0
如果提示pip版本问题,可执行：
python-mpipinstall--upgradepip
然后重新安装面板依赖,不同服务器的Python版本不同，如果存在多个Python版本，需要确认面板使用的Python路径，通常为 /www/server/panel/pyenv/bin/python，使用该解释器执行pip安装。
修复面板SQLite数据库
面板配置和任务记录存放在SQLite数据库中,数据库文件损坏会导致白屏，先备份数据库文件：
cp/www/server/panel/data/default.db/www/server/panel/data/default.db.bak
然后使用sqlite3检查：
sqlite3/www/server/panel/data/default.db"PRAGMAintegrity_check;"
如果返回结果不是 ok，可以尝试导出并重建：
sqlite3/www/server/panel/data/default.db".dump">/tmp/panel_db_dump.sql rm-f/www/server/panel/data/default.db sqlite3/www/server/panel/data/default.db</tmp/panel_db_dump.sql
完成后重启面板：
/etc/init.d/btrestart
如果数据库无法修复,可删除 default.db 后重启面板，面板会自动重建数据库，但会丢失部分面板配置和计划任务，网站数据不受影响。
检查面板端口、安全入口和防火墙
面板白屏有时不是程序错误,而是端口未放行或安全入口错误，查看面板端口：
cat/www/server/panel/data/port.pl
查看安全入口：
cat/www/server/panel/data/admin_path.pl
使用完整地址访问：http://服务器IP:端口/安全入口，如果使用云服务器，还需要在云控制台安全组放行该端口，服务器内部防火墙放行命令：
firewall-cmd--permanent--add-port=端口/tcp firewall-cmd--reload
或：
ufwallow端口/tcp
如果面板开启了SSL,可关闭SSL后重启，排除证书问题：
rm-f/www/server/panel/data/ssl.pl /etc/init.d/btrestart
处理面板域名绑定和Hosts解析
如果之前绑定过面板域名,域名解析失效也会导致面板白屏或无法访问，可查看面板域名配置：
cat/www/server/panel/data/domain.pl
如果不需要域名绑定,可删除该文件并重启面板：
rm-f/www/server/panel/data/domain.pl /etc/init.d/btrestart
同时检查服务器 /etc/hosts 文件是否将面板域名指向错误IP，如有异常可修正或删除对应条目。
升级系统组件并重启服务器
如果以上方法均无效,可能是系统底层组件损坏或长时间运行导致内核异常，可先更新系统软件包：
yumupdate-y
或：
aptupdate&&aptupgrade-y
更新完成后重启服务器：
reboot
服务器重启后,宝塔面板会随系统启动，再次访问面板地址，大部分因临时资源耗尽、进程挂死、内核异常导致的白屏问题会在重启后恢复。
卸载重装宝塔面板
若所有修复方法都无效,可考虑卸载重装面板，注意重装面板不会影响网站、数据库和FTP数据，但会重置面板配置，先备份面板配置：
cp-r/www/server/panel/data/www/server/panel/data_backup
执行官方卸载脚本：
/etc/init.d/btstop rm-rf/www/server/panel
重新安装面板：
curl-sSOhttps://download.bt.cn/install/install_6.0.sh&&bashinstall_6.0.sh
安装完成后根据提示获取新的面板地址、用户名和密码，登录后面板会重新识别原有网站和数据库，但需要重新设置计划任务、端口、安全入口等。
实际操作中,建议从第一节开始依次排查，多数白屏问题通过重启面板、清理缓存和修复脚本即可解决，无需重装，每一步操作前备份重要数据，尤其是数据库和面板配置文件，可有效避免二次故障。
