卸载重装PHP后Nginx报502错误，如何调试并配置PHP-FPM？

1. 先确认PHP-FPM是否正常运行 #

重装PHP后，先确定你安装的PHP版本（如7.4、8.1），执行命令检查服务状态：

systemctl status php<你的PHP版本>-fpm

示例：若安装的是PHP8.1，执行systemctl status php8.1-fpm

• 若显示服务未激活（inactive），启动服务并设置开机自启：

systemctl start php<你的PHP版本>-fpm
systemctl enable php<你的PHP版本>-fpm

• 若启动失败，查看详细错误日志定位问题：

journalctl -u php<你的PHP版本>-fpm

2. 检查Nginx配置文件的PHP转发规则 #

你的所有项目配置都在/etc/nginx/conf.d下，逐个检查每个项目的配置文件，确保处理PHP请求的location块配置正确：

location ~ \.php$ {
    # 替换为你的PHP版本，确保与PHP-FPM监听路径一致
    fastcgi_pass unix:/run/php/php<你的PHP版本>-fpm.sock;
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
}

如果PHP-FPM使用TCP端口监听（默认9000），则将fastcgi_pass改为127.0.0.1:9000。

检查Nginx配置语法合法性：

nginx -t

若提示“test is successful”，重启Nginx使配置生效：

systemctl reload nginx

3. 核对PHP-FPM的监听配置 #

打开PHP-FPM的pool配置文件，路径一般为/etc/php/<你的PHP版本>/fpm/pool.d/www.conf，找到listen相关配置：

• 若使用Unix套接字，确认以下配置：

listen = /run/php/php<你的PHP版本>-fpm.sock
listen.owner = www-data
listen.group = www-data
listen.mode = 0660

Nginx默认以www-data用户运行，需保证套接字权限允许Nginx访问。

• 若使用TCP监听，确认：

listen = 127.0.0.1:9000

修改后重启PHP-FPM：

systemctl restart php<你的PHP版本>-fpm

4. 查看错误日志定位具体问题 #

若以上步骤未解决问题，直接通过日志排查：

• Nginx错误日志：默认路径/var/log/nginx/error.log，搜索“502”关键词，会显示连接PHP-FPM失败的具体原因（如套接字文件不存在、权限不足、TCP连接被拒等）。
• PHP-FPM错误日志：路径一般为/var/log/php<你的PHP版本>-fpm.log，查看是否有启动失败、进程异常的信息。

关于conf.d和sites-available的说明 #

你提到的“配置PHP-FPM使用conf.d而非sites-available”是误解——sites-available只是Nginx的传统配置目录，conf.d是Nginx的另一种配置加载方式（直接读取目录下的.conf文件），PHP-FPM与Nginx配置文件的存放目录无关，只需保证Nginx配置里的fastcgi_pass指向PHP-FPM的正确监听地址即可。

内容的提问来源于stack exchange，提问作者Martin AJ