应启用php错误显示、检查web服务器配置、脚本中临时开启错误报告、验证错误日志并排除输出缓冲干扰。具体包括修改php.ini的display_errors和error_reporting，调整php-fpm和nginx配置，添加运行时错误指令，使用php -l检查语法，并关闭output_buffering或清空缓冲区。
如果您在运行 PHP 脚本时遇到错误，但浏览器页面空白或仅显示部分 HTML 内容而无任何错误提示，则很可能是 PHP 错误报告被禁用或输出被缓冲拦截。以下是解决此问题的步骤：
一、启用 PHP 错误显示
PHP 默认可能关闭了错误显示功能，尤其在生产环境中会将错误信息隐藏以避免暴露敏感信息。需手动开启 display_errors 配置项，使错误直接输出到浏览器。
1、找到当前 PHP 使用的配置文件 php.ini，可通过创建一个包含 phpinfo() 的 PHP 文件并访问来确认其路径。
2、用文本编辑器打开 php.ini 文件，搜索 display_errors，将其值修改为 On。
立即学习“PHP免费学习笔记（深入）”；
3、继续查找 error_reporting，确保其值不低于 E_ALL，推荐设置为 E_ALL & ~E_NOTICE & ~E_DEPRECATED（兼顾完整性与可读性）。
4、保存 php.ini 文件，重启 Web 服务器（如 Apache 或 Nginx）使配置生效。
二、检查 Web 服务器是否拦截 PHP 输出
某些 Web 服务器（尤其是 Nginx + PHP-FPM 组合）默认不将 PHP 错误转发至响应体，而是记录在错误日志中。需调整 PHP-FPM 或服务器配置以透传错误。
1、编辑 PHP-FPM 的 pool 配置文件（通常为 www.conf），查找 catch_workers_output，将其设为 yes。
2、在同一文件中确认 php_admin_flag[log_errors] 为 on，并检查 php_admin_value[error_log] 指向可写日志路径。
3、若使用 Nginx，确保 server 块中包含 fastcgi_intercept_errors off;，防止 Nginx 自行处理 500 类错误页而掩盖原始 PHP 错误。
三、在脚本中临时强制开启错误报告
当无法修改 php.ini 或需快速验证某段代码时，可在 PHP 文件开头插入运行时指令，覆盖当前脚本的错误控制行为。
1、在 PHP 文件最顶部（ 后立即添加），加入以下三行：
error_reporting(E_ALL);
ini_set('display_errors', '1');
ini_set('display_startup_errors', '1');
2、确保该代码位于任何输出（包括空格、BOM、HTML）之前，否则会因 headers already sent 报错而失效。
四、验证错误是否真实发生而非被静默忽略
部分错误（如 parse error、fatal error）在未启用 display_errors 时完全不输出，但可通过检查 PHP 错误日志确认是否存在异常。
1、执行命令 php -l your_script.php 对文件进行语法检查，查看是否返回 No syntax errors detected。
2、若使用 CLI 运行，直接执行 php your_script.php，终端将显示完整错误堆栈（不受 web 配置影响）。
3、查阅 php.ini 中 error_log 指定的路径，用 tail -f /path/to/php_error.log 实时监控新错误。
五、排除输出缓冲干扰
output_buffering 开启可能导致错误信息滞留在缓冲区未及时发送，尤其在脚本中途崩溃时造成“白屏”假象。
1、在 php.ini 中查找 output_buffering，临时设为 Off 或 0。
2、若无法修改全局配置，在脚本开头添加：if (ob_get_level()) { ob_end_flush(); } 强制清空已有缓冲。
3、检查是否有 ob_start() 调用未配对 ob_end_flush() 或 ob_end_clean()，导致错误输出被丢弃。
