ThinkPHP白屏无报错本质是PHP错误被多层屏蔽，需直触底层机制：一、在public/index.php首行<?php后立即插入error_reporting(E_ALL)和ini_set('display_errors','1')；二、全局启用php.ini中display_errors=On及error_reporting=E_ALL，并在Nginx/宝塔中同步配置；三、注释think\initializer\Error::register()或禁用exception_handle；四、验证PHP错误日志路径、权限及写入有效性。
ThinkPHP 白屏却无任何报错，本质是 PHP 错误被层层屏蔽了——不是没出错，而是错误根本没“露脸”。要让它显示出来，关键不是改框架配置，而是绕过所有中间层，直触 PHP 底层错误机制。
一、在入口文件最顶上强制开启错误显示
很多人的 ini_set('display_errors', '1') 写晚了。错误可能发生在自动加载、扩展缺失甚至语法错误阶段，那时框架代码都还没执行。
- 打开
public/index.php - 在第一行
<?php后面**立即插入两行**（确保在任何require、include或命名空间声明之前）：error_reporting(E_ALL);<br>ini_set('display_errors', '1'); - 保存，用浏览器访问，不要用命令行跑
php index.php—— CLI 环境不反映 Web 白屏问题
二、确认 PHP 层面的错误开关真打开了
ini_set 只作用于当前脚本，且可能被禁用（如 disable_functions）、被服务器配置覆盖，或执行太晚。必须确保底层真正生效：
- 查 php.ini：找到
display_errors = Off改为On；error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT（或直接E_ALL）；log_errors = On - Nginx 用户：在站点配置里加
fastcgi_param PHP_VALUE "display_errors=on; error_reporting=E_ALL;" - 宝塔用户：网站 → 设置 → PHP 版本 → 配置文件 → 修改后点「保存」并「重启 PHP」
三、关掉 ThinkPHP 自带的错误处理器
TP 5.1+ 默认启用 think\initializer\Error::register()，它会捕获 E_ERROR 等致命错误，转成 500 页面或静默丢弃，你看到的“白屏”其实是它处理后的结果。
立即学习“PHP免费学习笔记（深入）”；
- 在
public/index.php中，找到类似think\initializer\Error::register();的调用，暂时注释掉 - 或者确保
APP_DEBUG = true，并在config/app.php中把'exception_handle' => \think\exception\Handle::class改为null
四、检查日志是否真的在写
即使 display_errors 关了，错误也会进日志——但日志常因权限、路径或配置失效而“消失”：
- 运行
php -i | grep -E "log_errors|error_log"，确认log_errors = On且error_log是绝对路径（如/var/log/php_errors.log） - 检查该文件是否存在、可写：
ls -l /var/log/php_errors.log；若无，创建并授权：sudo touch /var/log/php_errors.log && sudo chown www-data:www-data /var/log/php_errors.log - 刷新页面后立刻执行：
tail -n 20 /var/log/php_errors.log，看是否有新内容
