Nginx 与 PHP-FPM 用 Unix socket 报 502:属主与用户组对齐排查

    发布时间:2026-09-30 12:32 更新时间:2026-09-30 12:32 阅读量:11

    把 Nginx 与 PHP-FPM 的连接方式从 127.0.0.1:9000 换成 Unix socket,通常是想省掉一点 TCP 开销、避免端口暴露。改完配置重载,静态页正常,首页却直接 502 Bad Gateway。翻 Nginx 错误日志往往只有一句 connect() to unix:/tmp/php-cgi.sock failed,看不出所以然。这类问题九成不是 PHP 崩了,而是 socket 文件的属主、权限跟 Nginx 的工作进程对不上,属于典型的“配置写对了、身份没对齐”。下面按 sock 文件本身、FPM 池配置、Nginx 运行用户三处逐一排查。

    一、先确认 socket 文件到底是谁的、权限是多少

    Nginx 要连一个 Unix socket,前提是运行 Nginx worker 的那个系统用户,对 socket 文件有读写权限。注意这里看的是文件权限,不是目录权限,虽然目录权限也会拦人。先用一条命令把关键信息打出来:

    ls -l /tmp/php-cgi.sock
    

    典型输出:

    srw-rw---- 1 www www 0 Sep 1 10:00 /tmp/php-cgi.sock

    输出里第一个字符是 s,表示这是个 socket 文件。后面三组权限分别对应属主、属组、其他人。如果显示成 srw------- 且属主是 root,而 Nginx 以 www 身份运行,那必然连不上,日志里就是 502。反过来,如果 socket 权限给到 777,虽然能连通,但等于让同机器上任何用户都能向 FPM 发请求,不是好习惯。合理做法是让属主和属组都归到 Nginx 与 FPM 共用的那个用户组,权限给 660 左右。

    顺带看一下 socket 所在目录。很多人把 socket 放在 /tmp,而某些系统对 /tmp 有额外的挂载选项或清理策略;也有把 socket 放在网站目录下的,目录权限一旦收紧,Nginx 连目录都进不去。可以这样确认:

    namei -l /tmp/php-cgi.sock
    

    namei 会把路径上每一级目录的属主、权限都列出来,哪一级卡住一目了然。如果 socket 放在 /run 或 /var/run/php-fpm 下,还要留意该目录在重启后是否会被清空,具体以实际系统的 tmpfiles 规则为准。

    二、FPM 池里的 listen.owner、listen.group、listen.mode

    socket 文件的属主和权限不是手动 chown 出来的,而是 PHP-FPM 在启动时按池配置自己创建的。也就是说,光在命令行里改权限,重启 FPM 后又会变回去。真正要改的是 FPM 的池配置文件,通常在 /etc/php-fpm.d/www.conf,或宝塔环境下位于 /www/server/php/版本号/etc/php-fpm.d/ 目录下,具体路径以实际环境为准。

    ; /etc/php-fpm.d/www.conf 片段
    listen = /tmp/php-cgi.sock
    listen.owner = www
    listen.group = www
    listen.mode = 0660
    
    ; 下面这两行决定 FPM 工作进程以谁的身份跑
    user = www
    group = www
    

    这里有几个容易踩的点。第一,listen.owner 和 listen.group 指的是 socket 文件归谁,跟你用哪个用户跑 PHP 脚本不是一回事;第二,如果这两行被注释掉,FPM 会按编译时的默认值创建 socket,很多发行版默认是 nobody 或 apache,于是跟 Nginx 的 www 对不上;第三,listen.mode 写成 0660 时,只有属主和属组能访问,所以必须保证 Nginx 的运行用户属于这个组,或者直接把 owner 设成 Nginx 的运行用户。

    最省事的对齐方式是:让 listen.owner 等于 Nginx 的运行用户,listen.group 也等于该用户的主组,mode 给 0660。这样 socket 一创建出来,Nginx 就有读写权限,不需要额外加组。改动后记得平滑重载,而不是只 reload:

    php-fpm -t                      # 先测配置语法
    systemctl reload php-fpm        # 或对应版本的服务名,如 php8.2-fpm
    ls -l /tmp/php-cgi.sock         # 再确认属主权限是否已变
    

    宝塔面板里如果是通过面板管理 PHP 版本,直接改配置文件有可能被面板覆盖,建议在面板对应 PHP 版本的配置界面里调整,或改完在面板里点一次重载,避免两处配置打架。

    三、Nginx 侧的用户与 fastcgi_pass 写法

    前两处都对齐了还报 502,就要看 Nginx 自己以什么身份运行。主配置 nginx.conf 顶部的 user 指令决定 worker 进程的用户,Debian/Ubuntu 常见是 www-data,CentOS 系常见是 nginx 或 www。FPM 的 listen.owner 必须跟它一致,或者同组。确认命令:

    ps -eo user,comm | grep -E 'nginx|php-fpm'
    

    输出里 nginx 的 worker 进程用户,就是要跟 socket 属主对齐的那个。接着检查站点配置里的 fastcgi_pass,切到 socket 后必须写成 unix: 前缀加绝对路径,不能只写路径:

    location ~ \.php$ {
        fastcgi_pass unix:/tmp/php-cgi.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
    

    路径写错、少个冒号、大小写不符,都会得到同样的 502。另一个隐蔽的坑是 SELinux:在开启 enforcing 的系统上,即使文件权限看起来没问题,Nginx 也可能因为安全上下文被拒绝访问 socket。可以先临时用 setenforce 0 验证是否是这个原因,确认后再按官方文档为 socket 目录设置合适的上下文,不要长期关闭 SELinux,具体策略以发行版文档为准。

    排查顺序建议固定下来:先看 Nginx 错误日志的具体报错,再用 ls -l 与 namei 确认 socket 文件与路径权限,然后核对 FPM 池里的 listen.owner/listen.group/listen.mode,最后确认 Nginx worker 用户与 fastcgi_pass 写法。多数情况下,把这三处的用户名统一成同一个,问题就消失了。改完配置后,先 php-fpm -t 测语法,再 reload FPM,最后 reload Nginx,顺序反了容易在中间态看到假故障。建议把 socket 路径和运行用户写进站点的部署备注,下次迁移或升级 PHP 版本时,第一件事就是重新核对这三处,能省掉不少无谓的 502 排查时间。

    继续阅读

    📑 📅
    宝塔面板 Nginx 反代 Node.js 与 Python:proxy_pass、WebSocket 与 502 排查 2026-09-30
    WordPress迁移后小工具和菜单丢失:序列化数据与WP-CLI替换思路 2026-09-30
    Nginx 与 PHP-FPM:Unix socket 还是 TCP,怎么选怎么切 2026-09-30
    网站上线前DNS预检清单:A/CNAME/MX/TXT记录核对与TTL切换节奏 2026-09-29
    宝塔面板多站点共用服务器MySQL连接数被打满的排查思路 2026-09-29
    宝塔面板站点开 HTTP/3:Nginx 版本、Brotli 与 CDN 回源链路评估 2026-09-30
    WordPress数据库MyISAM转InnoDB:引擎、行格式与写入观察 2026-09-30
    Nginx 限流不生效排查:zone、层级与 CDN 真实 IP 三个坑 2026-09-30
    宝塔多版本PHP站点选错版本:fastcgi_pass与.user.ini排查 2026-09-30
    宝塔面板站点被降权前的征兆:抓取频次、收录量与Nginx日志交叉观察 2026-10-01