一片纯白的页面,比任何报错都让人难受——报错好歹告诉你哪一行炸了,白屏什么都不说,连脾气都不发。打开网站是空白这种事我处理过太多回,最后能把方向定下来的,基本都不是靠猜,而是把日志翻出来对着看。服务器不吭声,但 error log 里该记的都记着,只是大部分人第一反应是重装、换主题、问客服,把最直接的证据绕过去了。

先分清是「200 的白」还是「500 的白」
这一步能省掉一半功夫。按 F12 打开 Network,刷新一下,看主文档那个请求的状态码。200 却是白页,说明请求成功了,问题多半在模板没输出内容、页面被清空、CSS 把内容藏了、或者编码乱掉;500 的白,大概率是 PHP 致命错误,而 display_errors 正好关着;404 的白往往是伪静态或者路径写歪;502、504 就是后端进程没起来或者超时,跟页面本身关系不大。命令行里 curl -I 域名 也能看到状态码和响应头,比在浏览器里点来点去快。
打开网站是空白,我从日志里找到原因——该翻哪几个文件
Nginx 的错误日志一般在 /var/log/nginx/error.log,访问日志是 access.log。用宝塔面板的更省事,站点的日志都在 /www/wwwlogs/ 下面,按域名分了 xxx.log 和 xxx.error.log。PHP 这边,php-fpm 的日志常见在 /var/log/php-fpm/www-error.log,编译安装的可能在 /www/server/php/版本/var/log/ 里。实时盯着看就用 tail -f /www/wwwlogs/你的域名.error.log,一边刷页面一边看,哪一行冒出来就是哪一行。
有个坑得提前说:php-fpm 池配置里 catch_workers_output 如果没开,PHP 的报错根本进不了 fpm 自己的日志,只会在 nginx 的 error.log 里留一句 upstream 相关的提示,看着像网络问题,其实是脚本挂了。所以两个文件要一起看,别盯一个。
PHP 的错误被关掉了,页面自然「干净」
线上环境 display_errors 基本都是 Off,这是对的,但排查的时候就得临时打开。改 php.ini 里的 display_errors = On、error_reporting = E_ALL,重启 php-fpm 再看。用框架的还要多一步:ThinkPHP 看 .env 里的 APP_DEBUG,Laravel 也是 .env 里的 APP_DEBUG=true,改成 false 的时候页面白得干干净净,日志里才有货。查完记得改回去,这东西开着让人看见路径和 SQL 不是闹着玩的。
磁盘满了、权限错了,也能白得彻底
df -h 看一眼根分区,再 df -i 看 inode。磁盘写满的时候,PHP 连 session 都写不进去,页面直接给你一片白,而且不一定是程序的问题——很多时候是日志文件自己把盘吃满了,站点日志没做切割,几个月堆下来就是几个 G。权限这块,runtime 目录、缓存目录、上传目录不可写,表现也常常是白屏而不是明确报错。目录所有者和 PHP 运行用户对不上,是最常见的一种。
伪静态规则写歪了,页面能绕成空气
rewrite 循环、try_files 少写一个参数、index 顺序不对,都会让请求在内部转圈,最后返回一个空 body 或者干脆 404。判断方法很简单,curl -I 看有没有 301 跳到自己的地址,浏览器地址栏没变但内容对不上,八成就是这类。改 nginx.conf 或者站点配置里 location 那段之前,先备份,改完 nginx -t 测一下再 reload,别直接重启。
CDN 和缓存那一层,也会递给你一片白
源站好好的,外面看是白的,这时候先别怀疑程序。在本地 hosts 里把域名指到源站 IP,绕开 CDN 直接访问一次,白不白立刻分明。如果源站正常、走 CDN 白,那就是回源失败、缓存存了一份空响应,或者压缩头处理有问题。清一次缓存再试,还是不行就去看 CDN 那边的回源状态码,别在服务器上瞎折腾。
日志一大堆看不懂,按时间对齐就行
access.log 里找到那次白屏请求的时间戳,再拿这个时间去 error.log 里搜同一秒,一条一条顺着往上找。请求 ID、upstream 地址、fastcgi 的返回,都能串起来。实在看不出来,就临时把 nginx 的 error_log 级别调到 debug,刷一次页面再调回来,量很大,但信息全。别一上来就重装环境,那等于把案发现场擦了。
顺序我一般这么走:状态码 → 日志最后几十行 → 磁盘和权限 → 伪静态 → 绕开 CDN 直连源站对比。五步走完还没头绪的,基本都属于环境层面的怪问题,这时候再考虑换运行时版本或者找服务商,也来得及。白屏不可怕,可怕的是不看日志就开始动手。
【版权声明】:本站内容若无意侵犯到您的权利,请及时与我们联系将尽快删除相关内容!