
白屏通常意味着 PHP 致命错误被隐藏。第一目标是保留现场并恢复管理能力,第二目标才是找到具体插件、主题或环境变更。
1. 先检查服务器与 PHP 日志
记录错误时间、请求路径和完整堆栈。不要在生产页面直接显示详细错误,以免泄露路径和配置。
2. 回顾最近变更
检查刚更新的插件、主题、PHP 版本和配置。若问题紧随某次变更出现,优先在备份环境复现。
3. 逐步隔离插件和主题
通过文件管理或命令行临时停用可疑插件,必要时切换到默认主题。一次只改变一个因素。
4. 修复后验证关键路径
检查首页、文章、登录、编辑、上传和定时任务。恢复插件前先确认兼容版本或获得正式修复。
常见误区
- 打开前台详细报错
- 一次禁用所有组件后无法定位
- 直接修改插件源码
- 只恢复首页不检查后台
执行检查清单
- 完整错误日志已保存
- 最近变更已列出
- 根因可重复验证
- 修复后关键流程通过
总结
白屏排查最忌讳同时做很多操作。围绕错误时间线逐项隔离,才能从临时恢复走到真正修复。