PHP页面空白主因是错误被静默屏蔽：display_errors关闭、error_log路径不可写、致命错误发生在框架加载前或输出缓冲未刷新；需开启错误显示、检查日志配置与权限、绕过缓冲并捕获shutdown错误。
PHP 页面空白不报错，不是代码没运行，而是错误被层层屏蔽了——display_errors 关着、error_log 没写对路径、致命错误发生在框架加载前，或者输出缓冲卡在半路。直接开错误显示、查日志、绕过缓冲，三步就能让问题“现形”。
怎么快速打开 PHP 错误显示（开发环境必做）
空白页第一嫌疑是 display_errors = Off，它让所有错误静默消失。不能只靠代码里 ini_set()，因为有些错误（比如语法错、require 路径错）连执行到那行的机会都没有。
- 打开
php.ini，确认两处设置：display_errors = Onerror_reporting = E_ALL - 如果用 phpStudy，点「软件管理 → PHP → 配置文件」；如果用 Nginx + PHP-FPM，还要检查池配置里有没有
php_admin_flag[display_errors] = on，它会覆盖php.ini - 改完必须重启 Web 服务（Apache/Nginx）和 PHP-FPM（如启用），否则无效
- 验证是否生效：在页面开头加
<?php echo $undefined_var; ?>，应该立刻看到Notice: Undefined variable
为什么开了 display_errors 还是空白？查 error_log 路径和权限
即使 display_errors = Off（生产环境合理），错误也得有地方可去。如果 log_errors = On 但 error_log 路径不可写，错误就彻底丢弃——你既看不到，也找不到。
- 在
php.ini中确认这四行都存在且正确：log_errors = Onerror_log = /var/log/php/error.log（Linux）或D:\phpstudy_pro\Extensions\php\php8.5.5nts\logs\php_error.log（Windows phpStudy）error_reporting = E_ALL & ~E_DEPRECATED & ~E_NOTICE（生产环境常用） - 重点检查
error_log文件所在目录的权限：Web 进程用户（如www-data、nginx或 Windows 下的IIS_IUSRS）必须有写权限，否则日志静默失败 - 临时测试：在脚本里加一行
error_log("test at " . date('Y-m-d H:i:s'));，然后tail -f看日志是否追加
ThinkPHP/Laravel 等框架白屏？入口文件和 autoload 是关键断点
框架白屏常发生在 public/index.php 第一行还没跑完的时候，比如 vendor/autoload.php 找不到、PHP 版本不兼容、或 APP_ENV 和 app_debug 冲突。
立即学习“PHP免费学习笔记（深入）”；
- 在
public/index.php最顶部（<?php后立刻）加诊断代码：<?php die(file_exists(__DIR__.'/../vendor/autoload.php') ? 'autoload OK' : 'autoload missing'); ?> - 确认
.env在项目根目录（与app/同级），不是public/下；且APP_ENV=dev必须显式设置，否则app_debug=true会被忽略 - Linux 部署时，
vendor/目录需保证 Web 用户有读+执行权限：chmod -R 755 vendor，否则autoload.php加载失败直接 500 白屏 - 别依赖框架的错误页——很多致命错误（如扩展缺失、内存耗尽）根本进不了框架层，
phpinfo()和php -l index.php才是第一道筛子
页面仍空白？检查 BOM、输出缓冲和意外输出
UTF-8 BOM 头、文件末尾空格、ob_end_clean() 或提前 header() 都会导致“headers already sent”，进而让后续内容无法输出，只剩空白。
- 用 VS Code 或 Notepad++ 打开 PHP 文件，确认编码是「UTF-8 无 BOM」——BOM 会在
session_start()前隐式输出，触发报错但不显示 - 检查所有被
include/require的配置文件，末尾不能有多余空行或空格 - 临时在脚本开头加：
if (function_exists('ob_get_level') && ob_get_level()) { ob_end_flush(); }再加register_shutdown_function()捕获最后错误：register_shutdown_function(function() { if ($e = error_get_last()) { var_dump($e); } }); - 用命令行验证语法：
php -l public/index.php，Parse error 类错误只能靠这个发现
真正卡住排查的，往往是 error_log 路径权限不对、autoload.php 权限不足、或者 BOM 头这种看不见的字符——它们不会报错，只会让一切静默失效。
