500 錯誤意為「伺服器內部錯誤」,原因極廣。本文整理新手最常遇到的 5 大類錯誤與快速排查步驟,助你從錯誤日誌直擊問題核心。
現象:腳本第一行 #!/usr/bin/perl 指向開發機路徑,生產機無此路徑。
修正:改為生產機實際路徑,如 #!/usr/local/bin/php 或 #!/usr/bin/php。用 which php 確認。
現象:程式寫死 /home/user/image,實際 DocumentRoot 為 /home/user/www。
修正:使用 $_SERVER['DOCUMENT_ROOT'] 或 dirname(__FILE__) 動態組合路徑:
$realPath = $_SERVER['DOCUMENT_ROOT'] . '/image/';
現象:設定檔寫 $email = 'admin@domain.com'; 在雙引號字串中 @domain 被 PHP 視為陣列變數插值。
修正:單引號包裹或跳脫:'admin@domain.com' 或 "admin\@domain.com"。
現象:某些虛擬主機配置導致 SCRIPT_NAME、PHP_SELF 回傳錯誤路徑。
修正:$_SERVER['REQUEST_URI'] 較可靠;或在入口檔定義常量 define('BASE_PATH', dirname(__DIR__)) 統一基準。
現象:腳本權限 644,SuEXEC 要求 755 且擁有者為執行使用者。
快速修正 (CuteFTP/FileZilla):右鍵檔案 → 檔案權限/屬性 → 輸入 755 → 確定。
命令列:chmod 755 script.cgi、chown user:group script.cgi。
tail -f /var/log/apache2/error.log 或 /var/log/nginx/error.log,錯誤訊息通常直指行號。ini_set('display_errors', 1);
error_reporting(E_ALL);
error_log 記錄 upstream prematurely closed connection → PHP-FPM 進程崩潰 (段錯誤、OOM、max_execution_time)。slowlog 找出慢請求;request_terminate_timeout 設定是否過短。dmesg | grep -i php 看核心是否殺掉進程 (OOM Killer)。500 錯誤不可怕,**日誌是唯一真理**。養成「先看 Log、再改 Code」習慣,配合版本控制 (Git) 快速回滾,能將排查時間從小時壓縮至分鐘。