页面白屏第一反应:翻Tigshop开源商城的runtime/log 客户发来一张截图页面全白什么都没有。这种情况刷新一百遍也没用tigshop 单商户是 ThinkPHP 8报错都落盘了第一件事是去翻日志php/runtime/log/按日期找最新那个文件白屏那一刻的异常堆栈基本就在末尾几行报错信息、出错的文件、行号写得清清楚楚比对着白屏干瞪眼强。如果日志里看不出问题或者想确认某段代码到底走没走到临时在可疑的位置打一行日志usethink\facade\Log;Log::write($data,debug);// 排查完删掉别留在生产里Log::write的第二个参数是日志级别写进去之后在runtime/log/对应日期的文件里就能看到。定位完记得把这行删了别带上生产。光看 TP 的日志有时候不够白屏也可能是请求根本没进到 PHP或者是 PHP 进程本身挂了。这时候配合 Nginx 的error_log和 PHP-FPM 的错误日志一起看两边对一下时间点很快能判断卡在哪一层。按经验网上喊Tigshop 500 / 白屏的绝大多数落在这么几样上runtime目录没写权限、PHP 扩展没装齐、.env配错连不上数据库或 Redis。挨个排一遍基本就出来了。最后一条务必确认生产环境.env里的APP_DEBUG要设成false。开着调试出错时会把完整的错误路径和堆栈直接返回到页面上等于把服务端结构晒给外面看排查完顺手改回去。