PHP 空白頁面排查指南：常見原因與解決方案

現象描述

瀏覽器訪問 PHP 頁面時，完全無任何輸出（連 HTML 骨架都沒有），查看源代碼也是空白。這比報錯更讓人崩潰，因為沒有任何線索。

核心排查步驟

1. 確認 PHP 引擎是否運行

建立 test.php：

<?php phpinfo(); ?>

若正常顯示，說明 PHP-FPM/Apache 模塊工作正常；否則檢查服務狀態、端口、權限、錯誤日誌。

2. 開啟錯誤顯示（臨時）

在腳本最頂部添加：

<?php
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);
?>

或修改 php.ini：

display_errors = On
display_startup_errors = On
error_reporting = E_ALL

生產環境調試完畢務必關閉！

3. 檢查 Web 服務器錯誤日誌

• Nginx：/var/log/nginx/error.log
• Apache：/var/log/apache2/error.log 或 /var/log/httpd/error_log
• PHP-FPM：/var/log/php-fpm/error.log（或 pool 定義的 php_admin_value[error_log]）

常見日誌關鍵字：Permission denied、No such file or directory、Allowed memory size exhausted、Maximum execution time exceeded。

高頻原因與對策

原因一：語法錯誤導致解析失敗

如漏分號、括號不匹配、關鍵字拼寫錯誤。PHP 解析階段出錯不會進入運行階段，若 display_errors=Off 直接白屏。

對策：命令行執行 php -l your_script.php 做語法檢查。

原因二：致命錯誤（Fatal Error）

• 調用未定義函數/類
• 實例化不存在的類
• 內存耗盡（memory_limit）
• 執行超時（max_execution_time）
• require/include 失敗（文件不存在、權限不足）

對策：查看錯誤日誌定位行號；臨時開啟 display_errors。

原因三：輸出緩衝/壓縮衝突

ob_start() 後未 ob_end_flush()、多層緩衝嵌套、zlib.output_compression 與 ob_gzhandler 衝突。

對策：檢查代碼中所有 ob_* 調用；嘗試在入口文件最頂部加 ob_end_clean()。

原因四：HTTP 頭已發送導致 header()/session_start() 失效

在任何輸出（包括 BOM、空白行、echo、HTML）之前調用 header()、setcookie()、session_start() 會觸發警告並導致後續邏輯中斷。

對策：確保 緊貼文件開頭，無 BOM（用 file -i 或編輯器「UTF-8 無 BOM」保存）。