phpEnv Nginx 502 Bad Gateway错误排查与解决方法-php教程-PHP中文网

php-fpm进程存活且可连接是解决502错误的前提，需依次确认服务状态、监听方式、fastcgi_pass严格匹配、缓冲与超时设置、socket权限及用户组归属。

phpenv nginx 502 bad gateway错误排查与解决方法

502 错误最常见原因是 Nginx 根本连不上 PHP-FPM，而不是配置写错了。先看服务有没有在跑、有没有监听对的地址。

执行 sudo systemctl status php-fpm（或 php8.1-fpm 等具体版本名），确认状态是 active (running)
若显示 inactive 或 failed，直接运行 sudo systemctl start php-fpm 启动
检查 PHP-FPM 实际监听方式：sudo ss -tlnp | grep php-fpm，看输出是 127.0.0.1:9000 还是 /run/php/php8.1-fpm.sock
若用 socket，手动测试连通性：curl -I --unix-socket /run/php/php8.1-fpm.sock http://localhost；返回 200 才算通

哪怕多一个空格、少一个斜杠，Nginx 就会静默失败并返回 502。这个匹配必须字面级精确。

打开站点 Nginx 配置（如 /www/server/nginx/conf/vhost/xxx.conf），找到 location ~ \.php$ 块
检查 fastcgi_pass 的值：如果 PHP-FPM listen = /run/php/php8.1-fpm.sock，那这里必须写 fastcgi_pass unix:/run/php/php8.1-fpm.sock;（注意 unix: 前缀和分号）
如果 PHP-FPM 改成监听 127.0.0.1:9000，Nginx 里就得写 fastcgi_pass 127.0.0.1:9000;，不能写 localhost —— 某些系统下 localhost 解析慢或失败
改完务必运行 nginx -t 测试语法，再 nginx -s reload 生效

PHP 脚本输出内容大（比如导出 Excel、生成 PDF）、或响应慢（数据库卡住），Nginx 默认缓冲和超时会直接切断连接，报 502。

Openclaw Gateway Guardian

OpenClaw网关守护 - 自动监控、保护与重启OpenClaw网关服务，防止网关停止、崩溃或消失。

下载

在 location ~ \.php$ 块内追加这几行（根据实际负载调整数值）：
fastcgi_buffer_size 128k;
fastcgi_buffers 4 256k;
fastcgi_busy_buffers_size 256k;
fastcgi_connect_timeout 300;
fastcgi_send_timeout 300;
fastcgi_read_timeout 300;
特别注意 fastcgi_read_timeout：它控制 Nginx 等待 PHP 返回响应的总时间，不是脚本执行时间，但必须大于 PHP 的 max_execution_time
如果用了宝塔面板，在网站 → 设置 → 配置文件 → “伪静态” 标签页下方可直接编辑，别只点“保存”，要点“重载配置”

即使路径对、进程在跑，Nginx 工作进程（通常是 www 或 www-data 用户）没权限读写 socket 文件，照样 502。

查 socket 文件属主：ls -l /run/php/php8.1-fpm.sock，输出类似 srw-rw---- 1 www www 0 Apr 21 15:20 /run/php/php8.1-fpm.sock
若第二列（组）不是 www，或权限不含 w（如只有 rw----），就需改：sudo chown root:www /run/php/php8.1-fpm.sock && sudo chmod 660 /run/php/php8.1-fpm.sock
同时确认 PHP-FPM 池配置（/www/server/php/81/etc/php-fpm.d/www.conf）中：
listen.owner = www
listen.group = www
listen.mode = 0660
改完重启 PHP-FPM：sudo systemctl restart php-fpm