萬盛學電腦網

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

PHP 5.3.29 升級導致 Nginx 502 Bad Gateway 根因分析與修復

PHP-FPM Unix Socket 權限變更導致 Nginx 502 故障排查實錄

PHP 5.3.28 升級至 5.3.29 (5.3 系列最終版) 後,Nginx + PHP-FPM Unix Socket 通信突然出現 502 錯誤。本文記錄從現象觀察、假設驗證、根因定位到修復的完整排查過程。

故障現象

  • 靜態資源 (HTML/CSS/JS/圖片) 正常訪問
  • 所有 PHP 頁面返回 502 Bad Gateway
  • PHP-FPM 進程正常運行 (未崩潰)
  • 切換為 TCP 模式 (127.0.0.1:9000) 立即恢復正常

排查邏輯鏈


502 Bad Gateway
    │
    ├── Nginx 無法連接上游 (PHP-FPM)
    │       │
    │       ├── PHP-FPM 進程異常退出? → 否,進程存活
    │       ├── PHP-FPM 監聽端口/Socket 異常? → 是
    │       │       │
    │       │       ├── TCP 模式正常 → 網絡層通
    │       │       └── Unix Socket 模式失敗 → Socket 文件/權限問題
    │       │
    │       └── Nginx 配置錯誤? → 未變更,排除
    │
    └── 結核: Unix Socket 文件權限導致 Nginx 無法讀寫

根因定位:Socket 文件權限變更

# 升級後 Socket 權限
$ ls -l /tmp/php-cgi.sock
-rwx------. 1 root root 663 Sep 18 00:16 php-cgi.sock  # 權限 700,僅 root 可讀寫

# 升級前 Socket 權限 (另一台未升級服務器)
$ ls -l /tmp/php-cgi.sock
srw-rw-rw- 1 root root 0 Sep 16 21:11 php-cgi.sock  # 權限 666,所有用戶可讀寫

關鍵發現

PHP 5.3.29 修改了 PHP-FPM 默認 Socket 權限從 0666 變為 0700,導致以 www 用戶運行的 Nginx 無法連接以 root 權限創建的 Socket 文件。

修復方案:PHP-FPM 配置顯式設置權限

; php-fpm.conf 或 www.conf
[www]
listen = /tmp/php-cgi.sock
listen.owner = www      ; Socket 文件擁有者
listen.group = www      ; Socket 文件群組
listen.mode = 0666      ; Socket 文件權限 (關鍵!)
user = www              ; 進程運行用戶
group = www             ; 進程運行群組

驗證修復

# 重啟 PHP-FPM
service php-fpm restart

# 檢查 Socket 權限
$ ls -l /tmp/php-cgi.sock
srw-rw-rw- 1 www www 0 Sep 18 10:30 php-cgi.sock  # 權限恢復 666,擁有者為 www

# 測試 Nginx 訪問
curl -I https://localhost/
# HTTP/1.1 200 OK

深度分析:為什麼 5.3.28 正常?

  • PHP 5.3.28 默認 listen.mode = 0666 (源碼默認值)
  • PHP 5.3.29 變更:相關提交 修改了默認值或行為
  • 編譯參數未變,但運行時默認行為改變
  • 升級腳本未同步更新 php-fpm.conf 中的顯式配置

最佳實踐:避免類似升級故障

  1. 顯式配置所有關鍵參數:不依賴默認值,php-fpm.conf 中明確寫出 listen.mode、listen.owner、listen.group
  2. 版本升級前測試:預發環境完整驗證、灰度發布
  3. 基礎設施即代碼:Ansible/Docker 管理配置,版本控制、可審計、可回滾
  4. 監控告警:Nginx 錯誤率、PHP-FPM 進程數、Socket 文件狀態監控
  5. 優先使用 TCP:127.0.0.1:9000 避免 Socket 權限、文件系統、SELinux 等問題,性能差異微乎其微

補充:Nginx 配置對照

# Unix Socket (需權限配置)
upstream php_backend {
    server unix:/tmp/php-cgi.sock;
}

# TCP 模式 (推薦,無權限煩惱)
upstream php_backend {
    server 127.0.0.1:9000;
}

server {
    location ~ \.php$ {
        fastcgi_pass php_backend;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}
copyright © 萬盛學電腦網 all rights reserved