ThinkPHP白屏主因是PHP错误显示未真正开启：需在php.ini或Web服务器配置中全局启用display_errors，而非仅用ini_set；同时确保error_reporting非0，并禁用TP错误处理器以暴露原始报错。
白屏但 ini_set('display_errors', '1') 不生效？先确认 PHP 错误显示开关是否真被激活
ThinkPHP 白屏且日志为空，最常被忽略的是：PHP 层面的错误显示根本没打开，ini_set 被禁用或执行太晚。它只在运行时修改当前脚本的配置，若错误发生在框架加载前（比如入口文件语法错、扩展缺失），ini_set 根本没机会执行。
-
display_errors必须在php.ini中设为On，或通过.htaccess（Apache）/php_admin_flag（Nginx + PHP-FPM）全局开启，不能只依赖ini_set - 检查
error_reporting是否被设为0或E_NONE—— 即使display_errors=On，报告级别为 0 也照样不显示 - 在
public/index.php最顶部（任何require前）加三行诊断代码：error_reporting(E_ALL);<br>ini_set('display_errors', '1');<br>ini_set('log_errors', '0');确保它不是被后续框架逻辑覆盖
ThinkPHP 自带错误处理器屏蔽了原始 PHP 错误？关掉它再试
ThinkPHP 5.1+ 默认启用异常捕获和错误处理，会拦截 E_ERROR 等致命错误并转为 500 页面或静默丢弃，导致你根本看不到原始报错信息。
- 临时禁用 TP 的错误处理：在
public/index.php中注释或删除think\initializer\Error::register()这一行 - 或者手动关闭调试模式：确保
APP_DEBUG为true，且config/app.php中'exception_handle' => \think\exception\Handle::class暂时改成null - 注意：TP 日志默认写入
runtime/log/，但如果runtime目录不可写、或log.type配置为test，日志也会“消失”——直接查storage/logs/（TP6）或runtime/log/（TP5）目录权限和实际文件是否存在
ini_set('display_errors', '1') 在 CLI 下无效？别在命令行里测 Web 错误
很多人在终端跑 php public/index.php 测试白屏问题，但 CLI SAPI 默认关闭 display_errors，且 ThinkPHP CLI 环境和 Web 环境的配置、路由、中间件完全不同 —— 这个操作基本没意义。
- Web 白屏必须在真实 HTTP 请求中复现：用浏览器访问，或
curl -I http://your-site/看响应头和状态码 - CLI 下即使开了
display_errors，也不会输出 HTML 错误堆栈（PHP 默认只输出纯文本），和浏览器看到的“白屏”不是一回事 - 如果 CLI 下能跑通但 Web 下白屏，优先排查 Web 服务器配置：Nginx 是否漏了
fastcgi_param PHP_VALUE "display_errors=on";？Apache 是否启用了php_flag display_errors on？
常见“伪白屏”场景：HTTP 500 但页面空，其实是输出被提前终止
不是所有白屏都源于 PHP 错误 —— 更多时候是响应体被截断、gzip 冲突、BOM 头、或输出缓冲未刷出，浏览器收不到完整 HTML。
立即学习“PHP免费学习笔记（深入）”；
- 用浏览器开发者工具看 Network → Response，确认返回内容是否为空，还是只有
<!DOCTYPE html>开头就断了 - 检查
public/index.php文件开头是否有 UTF-8 BOM（尤其 Windows 编辑器保存时容易带上），会导致 header 发送失败，后续输出全失效 - 在
index.php末尾加ob_end_flush();强制清空输出缓冲，排除缓冲层干扰 - 临时禁用 Nginx 的
gzip或 Apache 的mod_deflate，某些压缩模块与 PHP 输出缓冲冲突会导致空响应
phpinfo() 里的 display_errors 和 error_reporting 实际值，比反复改 TP 配置更有效。 
