PHP 5.3.28 升級至 5.3.29 (5.3 系列最終版) 後,Nginx + PHP-FPM Unix Socket 通信突然出現 502 錯誤。本文記錄從現象觀察、假設驗證、根因定位到修復的完整排查過程。
502 Bad Gateway127.0.0.1:9000) 立即恢復正常
502 Bad Gateway
│
├── Nginx 無法連接上游 (PHP-FPM)
│ │
│ ├── PHP-FPM 進程異常退出? → 否,進程存活
│ ├── PHP-FPM 監聽端口/Socket 異常? → 是
│ │ │
│ │ ├── TCP 模式正常 → 網絡層通
│ │ └── Unix Socket 模式失敗 → Socket 文件/權限問題
│ │
│ └── Nginx 配置錯誤? → 未變更,排除
│
└── 結核: Unix Socket 文件權限導致 Nginx 無法讀寫
# 升級後 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.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
listen.mode = 0666 (源碼默認值)listen.mode、listen.owner、listen.group127.0.0.1:9000 避免 Socket 權限、文件系統、SELinux 等問題,性能差異微乎其微# 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;
}
}