PHP 5.3.29 升級導致 Nginx 502 錯誤根因分析：Unix Socket 權限預設值變更

現象

PHP 5.3.28 → 5.3.29 升級後，網站全站 502 Bad Gateway，靜態資源正常，PHP 請求全掛。Nginx 與 PHP-FPM 採 Unix Socket 通訊（/tmp/php-cgi.sock）。

排查邏輯

1. PHP-FPM 進程存活正常 → 排除進程 Crash。
2. 改用 TCP 127.0.0.1:1234 即恢復正常 → 確定為 Socket 通訊層問題。
3. 檢查 Socket 檔案權限：-rwx------ 1 root root（700），Nginx worker（通常 www-data）無讀寫權。
4. 對比 5.3.28 機器：srw-rw-rw- 1 root root（666），預設權限變更導致。

根因

PHP 5.3.29 修改了 php-fpm.conf 預設 Socket 權限（從 0666 改為 0700），且未在更新日誌明確說明。若部署腳本未顯式設定 listen.mode，升級即中招。

解決方案：在 php-fpm.conf 顯式宣告 Socket 權限

; php-fpm.conf 或 pool.d/www.conf
listen = /tmp/php-cgi.sock
listen.owner = www
listen.group = www
listen.mode = 0666

重載 PHP-FPM（systemctl reload php-fpm 或 kill -USR2），Socket 權限變為 srw-rw-rw-，502 即刻消失。

最佳實踐建議

1. 版本鎖定：生產環境鎖定 PHP 微版本，升級前在 Staging 完整跑測試套件。
2. 配置外顯化：所有關鍵參數（Socket 路徑、權限、進程數、超時）全部寫入配置檔，勿依賴預設值。
3. 監控補齊：Nginx error_log、PHP-FPM slowlog、Socket 檔案權限定期巡檢。
4. 傾向 TCP：高併發或跨主機場景建議改用 127.0.0.1:9000，避免 Socket 權限、檔案描述符洩漏等邊界問題。

結語

「微版本升級不應破壞相容性」是理想，現實卻常因預設值變更踩坑。顯式配置 > 信任預設，是運維鐵律。