本地php环境出现502 bad gateway错误时，很多开发者第一反应是环境崩了，其实只要按步骤排查，大部分情况都能快速解决。
一、先理解502错误的本质
502 bad gateway属于http状态码，意思是作为网关或代理的服务器，从上游服务器（也就是处理php请求的php-fpm或者mod_php模块）收到了无效的响应。简单说就是web服务器（nginx/apache）和php处理程序之间没沟通好，所以返回了这个错误。
二、nginx环境下的502排查与解决
1. 检查php-fpm是否正常运行
nginx处理php请求时，默认会通过fastcgi协议把请求转发给php-fpm，如果php-fpm没启动，肯定会报502。可以先查看php-fpm的状态：
# 查看php-fpm进程是否存在，根据自己的php版本调整命令，比如php7.4就换成php7.4-fpm ps aux | grep php-fpm # 如果没进程，尝试启动php-fpm sudo systemctl start php7.4-fpm # 设置开机自启避免下次再出现 sudo systemctl enable php7.4-fpm
2. 核对nginx的fastcgi配置
nginx的站点配置里，fastcgi_pass参数需要和php-fpm的监听地址一致，这是最常见的配置错误。先找到php-fpm的监听配置，一般在/etc/php/7.4/fpm/pool.d/www.conf里：
; 查看www.conf里的listen配置，常见有两种形式 ; 形式1：监听tcp端口 listen = 127.0.0.1:9000 ; 形式2：监听unix socket文件 listen = /run/php/php7.4-fpm.sock
然后核对nginx站点配置里的对应参数，比如php-fpm监听的是9000端口，nginx配置里就要写成：
location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}如果php-fpm用的是socket文件，fastcgi_pass就要写成unix:/run/php/php7.4-fpm.sock，同时要注意socket文件的权限，确保nginx运行用户（一般是www-data）有读写权限。
3. 检查资源是否耗尽
如果php-fpm进程数用完了，或者服务器内存不足，也会导致无法处理新请求出现502。可以调整php-fpm的进程配置，在www.conf里修改：
; pm模式选择动态或者静态，本地开发用dynamic即可 pm = dynamic ; 最大子进程数，根据本地内存调整，本地一般设20-50足够 pm.max_children = 50 ; 启动时的进程数 pm.start_servers = 10 ; 最小空闲进程数 pm.min_spare_servers = 5 ; 最大空闲进程数 pm.max_spare_servers = 20
三、apache环境下的502排查与解决
1. 检查php模块是否正常加载
apache处理php一般有两种方式，一种是mod_php模块，一种是和nginx一样通过php-fpm走代理。如果是mod_php模式，先检查模块是否加载：
# 查看apache已加载的模块，看有没有php7_module apache2ctl -M | grep php
如果没有加载，需要安装对应版本的libapache2-mod-php包，然后重启apache：
sudo apt install libapache2-mod-php7.4 sudo systemctl restart apache2
2. 代理模式下的配置核对
如果apache用的是代理方式转发请求到php-fpm，需要检查代理配置是否正确，比如配置片段：
<FilesMatch \.php$>
SetHandler "proxy:unix:/run/php/php7.4-fpm.sock|fcgi://localhost"
</FilesMatch>这里的socket路径要和php-fpm的监听路径一致，如果php-fpm用的是tcp端口，就改成proxy:fcgi://127.0.0.1:9000。
3. 检查apache和php-fpm的权限
apache的运行用户一般是www-data，要确保php-fpm的socket文件或者端口，以及站点目录的权限正确，避免出现权限不足导致的通信失败。
四、通用排查小技巧
如果以上步骤都没问题，可以查看web服务器和php-fpm的错误日志，日志里会有更详细的报错信息：
- nginx错误日志一般在/var/log/nginx/error.log
- apache错误日志一般在/var/log/apache2/error.log
- php-fpm错误日志一般在/var/log/php7.4-fpm.log
根据日志里的具体报错提示调整配置，基本都能解决502的问题。如果是本地临时搭建的环境，也可以尝试重启所有相关服务，很多时候重启就能解决偶发的通信异常。
phpnginxapache502_bad_gatewayphp_fpm修改时间：2026-05-30 23:19:41