PHP 空白頁面常見原因與解決方案

現象描述

PHP 腳本執行後瀏覽器呈現完全空白頁面，無任何錯誤提示，排查難度較大。本文歸納四大核心成因並給出針對性解決策略。

一、邏輯錯誤——最隱蔽的殺手

代碼語法合法、結構正規，但執行結果與預期不符。常見於條件分支覆蓋不全、迴圈終止條件錯誤、變量作用域誤解等場景。

調試技巧：使用註釋符 /* */ 分段屏蔽代碼，觀察輸出變化，逐步縮小問題範圍。保持耐心，靜心分析邏輯流向。

二、行為未定義——缺失的預設分支

<?php
$action = $_GET['id'];
if ($action == '') $action = 1;
if ($action == 1) {
    echo "$action's value is 1";
} else if ($action == 2) {
    echo "$action's value is 2";
}
?>

當 $action 既不等於 1 也不等於 2 時，程式無任何輸出，導致空白頁面。

修正：在條件塊末尾添加 else 兜底處理，輸出提示資訊或記錄日誌。

三、語法錯誤被靜默吞噬

部分虛擬主機（如早期免費空間）關閉了錯誤顯示，導致語法錯誤不拋出任何訊息。

解決：本地開發環境開啟 display_errors = On 並設定 error_reporting = E_ALL，上線前務必在本地完整測試。

四、錯誤抑制符 @ 濫用

// test1.php
<?php
@include("test2.php");
echo $var;
?>

// test2.php
<?php
$var = "Hi"  // 缺少分號
$var1 = "Hello" // 缺少分號
?>

@ 抑制了 include 產生的解析錯誤，導致腳本靜默終止。

修正：移除 @ 讓錯誤浮現，或修正被包含文件的語法錯誤。

最佳實踐建議

• 開發階段啟用最高級別錯誤報告。
• 避免使用 @，改用 try-catch 或條件判斷處理可預期錯誤。
• 建立統一的異常處理與日誌記錄機制。