ThinkPHP关闭调试模式后空白页，主因是PHP错误被拦截隐藏：须全局开启display_errors=On、error_reporting=E_ALL，注释think\initializer\Error::register()，确保runtime可写且无BOM头。
ThinkPHP 关闭调试模式（APP_DEBUG = false）后出现空白页，不是因为“没东西可输出”，而是关键错误被层层拦截、隐藏或无法写入——它比开启调试时更难暴露。排查要绕过框架封装，直击 PHP 底层执行环节。
先让 PHP 把错误真正吐出来
TP 关闭调试后，默认禁用所有错误显示和日志写入，连 ini_set('display_errors', '1') 都可能失效（因错误发生在框架加载前）。必须从服务器配置级打开：
- 进宝塔 → 网站 → 对应站点 → 设置 → PHP 版本 → 配置文件，确认
display_errors = On且error_reporting = E_ALL（不能带& ~E_NOTICE这类过滤） - 改完务必点「保存」+「重启 PHP」，仅重载不生效
- 在
public/index.php最顶部（任何require前）加三行强制覆盖：error_reporting(E_ALL);<br>ini_set('display_errors', '1');<br>ini_set('log_errors', '0');
检查 runtime 目录是否真能写
关闭调试后，TP 会尝试生成缓存文件（如 ~app.php、~route.php），一旦 runtime/ 不可写，就静默失败、直接白屏：
- 执行
ls -ld runtime/，确认权限为drwxrwxr-x或类似（775） - 运行
chown -R www:www runtime/（宝塔默认 PHP 用户是www） - 手动创建一个测试文件：
touch runtime/test_write && rm runtime/test_write，验证写入能力 - 检查
runtime/cache/和runtime/log/下是否有当天生成的文件；没有，说明写入链路断了
排除 BOM 头与编码问题
关闭调试后，TP 会合并并写入 PHP 缓存文件。若任意配置文件（如 config/app.php）含 UTF-8 BOM，会导致生成的 ~app.php 开头多出不可见字符，PHP 解析失败，直接终止——不报错、不日志、只留白：
立即学习“PHP免费学习笔记（深入）”；
- 用 VS Code 或 Notepad++ 打开所有
config/和common/下的 PHP 文件 - 查看右下角编码标识，如果是
UTF-8 with BOM，另存为UTF-8 无 BOM - 特别注意
config/database.php和config/app.php，这两个最常中招
关掉 TP 自带的错误处理器
即使 PHP 错误已开启，ThinkPHP 5.1+ 的 think\initializer\Error::register() 仍会捕获 E_ERROR 并转成 500 或丢弃。你看到的“空白”，其实是 TP 吃掉了原始致命错误：
- 打开
public/index.php，找到think\initializer\Error::register()这一行，用//注释掉 - 或者临时把
config/app.php中的'exception_handle' => \think\exception\Handle::class改成'exception_handle' => null - 刷新页面，如果此时出现红色
Fatal error，说明问题定位成功
不复杂但容易忽略
