萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

CGI/PHP 500 Internal Server Error 常見原因與排查清單

前言

500 錯誤意為「伺服器內部錯誤」,原因極廣。本文整理新手最常遇到的 5 大類錯誤與快速排查步驟,助你從錯誤日誌直擊問題核心。

錯誤類別與解決方案

1. Shebang 行 (解譯器路徑) 錯誤

現象:腳本第一行 #!/usr/bin/perl 指向開發機路徑,生產機無此路徑。

修正:改為生產機實際路徑,如 #!/usr/local/bin/php 或 #!/usr/bin/php。用 which php 確認。

2. 絕對路徑誤判 (虛擬主機陷阱)

現象:程式寫死 /home/user/image,實際 DocumentRoot 為 /home/user/www。

修正:使用 $_SERVER['DOCUMENT_ROOT'] 或 dirname(__FILE__) 動態組合路徑:

$realPath = $_SERVER['DOCUMENT_ROOT'] . '/image/';

3. 程式碼中含有未跳脫的特殊字元 (如 @ 被誤判為陣列)

現象:設定檔寫 $email = 'admin@domain.com'; 在雙引號字串中 @domain 被 PHP 視為陣列變數插值。

修正:單引號包裹或跳脫:'admin@domain.com' 或 "admin\@domain.com"。

4. 環境變數異常 (如 $_SERVER['SCRIPT_NAME'] 錯誤)

現象:某些虛擬主機配置導致 SCRIPT_NAME、PHP_SELF 回傳錯誤路徑。

修正:$_SERVER['REQUEST_URI'] 較可靠;或在入口檔定義常量 define('BASE_PATH', dirname(__DIR__)) 統一基準。

5. 檔案權限不足 (CGI/SuEXEC 環境)

現象:腳本權限 644,SuEXEC 要求 755 且擁有者為執行使用者。

快速修正 (CuteFTP/FileZilla):右鍵檔案 → 檔案權限/屬性 → 輸入 755 → 確定。

命令列:chmod 755 script.cgi、chown user:group script.cgi。

通用排查流程 (必做三步)

  1. 查看錯誤日誌:tail -f /var/log/apache2/error.log 或 /var/log/nginx/error.log,錯誤訊息通常直指行號。
  2. 開啟 PHP 顯示錯誤 (暫時):
    ini_set('display_errors', 1);
    error_reporting(E_ALL);
  3. 最小化重現:註解大部分程式碼,逐段恢復定位問題行。

進階:PHP-FPM + Nginx 500 排查

  • Nginx error_log 記錄 upstream prematurely closed connection → PHP-FPM 進程崩潰 (段錯誤、OOM、max_execution_time)。
  • 檢查 PHP-FPM slowlog 找出慢請求;request_terminate_timeout 設定是否過短。
  • dmesg | grep -i php 看核心是否殺掉進程 (OOM Killer)。

結語

500 錯誤不可怕,**日誌是唯一真理**。養成「先看 Log、再改 Code」習慣,配合版本控制 (Git) 快速回滾,能將排查時間從小時壓縮至分鐘。

copyright © 萬盛學電腦網 all rights reserved