下面三个现象几乎每个 PHP 开发者都遇到过。它们的共同点是:页面看起来什么都没说,但日志里其实有答案。养成先看日志的习惯,能省掉大量猜测。

一、白屏(HTTP 200 但无内容)

白屏通常意味着脚本执行中断,但错误没有显示。按顺序检查:

  1. 打开 display_errors,或用 php -l 检查语法;
  2. 看 PHP 错误日志(宝塔一般是 /www/wwwlogs/php-fpm.log 或站点 error.log);
  3. 确认不是 exit、die 被提前触发;
  4. 如果用了 OPcache,清一次缓存再试。

常见原因是内存超限(Allowed memory size exhausted)或调用了不存在的函数——后者在 PHP 7 之后是 Error 而非 Fatal error,某些老框架的错误处理抓不到。

二、500 Internal Server Error

500 是服务器层面的错误,说明 PHP 进程崩了或配置有问题。排查顺序:

  • 语法错误:php -l file.php 逐个大改过的文件检查;
  • 权限问题:文件属主不对,PHP-FPM 读不到,日志里是 Permission denied;
  • .htaccess / 伪静态:规则写错导致循环重写;
  • 扩展缺失:用了 mysqli 但没装扩展。
# 快速定位
tail -n 50 /www/wwwlogs/你的域名.error.log
tail -n 50 /www/server/php/71/var/log/php-fpm.log
php -l /www/wwwroot/站点/index.php

三、Headers already sent

错误信息会明确告诉你”输出已经在第 X 行开始”。三种典型原因:

原因 表现 处理
文件带 BOM 第 1 行就报 转成 UTF-8 无 BOM
?> 后有空格或空行 报在文件末尾 纯 PHP 文件去掉结束标记
前面有 echo / 空行输出 报在实际输出行 把 header 调用提前,或用 ob_start
<?php
// 兜底方案:在文件最开头开启输出缓冲
ob_start();

// ... 业务逻辑

header('Location: /login');
exit;

一个通用习惯

把 error_reporting(E_ALL) 和 log_errors=On 固定在开发环境,并且每天开工前先 tail 一下日志。很多问题在变成故障之前,日志里已经有征兆了。

本文为 PHP 学习与排错的经验整理。示例代码以通用环境为前提,请结合自身 PHP 版本与服务器配置调整;涉及生产环境的变更,建议先备份并在测试环境验证。