排查Linux环境下Nginx与PHP-FPM连接失败导致PHP页面无法访问的问题
许多用户在配置Nginx与PHP-FPM协同工作时，会遇到Nginx配置完成后无法访问PHP页面，通常返回502错误码。本文将分析一个具体的Nginx配置文件，并提供相应的排查方法。
问题描述： 以下Nginx配置文件配置后，无法通过浏览器访问PHP页面：
server {
listen 80;
server_name www.web.com;
location / {
index front.php index.html index.php;
root /home/wwwroot/default/web;
}
location ~ \.php$ {
root /home/wwwroot/default/web;
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
# ... (其他location配置) ...
}
此配置旨在将Nginx的80端口与监听9000端口的PHP-FPM连接起来处理PHP请求，但实际访问时却出现5xx错误。
立即学习“PHP免费学习笔记（深入）”；
问题原因及排查：
首先，查看Nginx日志文件（access.log 和 error.log）。日志中记录了详细的请求处理过程和错误信息，这对于定位问题至关重要。
其次，5xx错误，特别是502错误，通常表示与上游服务器（PHP-FPM）的通信失败。可能原因如下：
-
PHP-FPM未运行或监听端口错误： 配置文件中PHP-FPM监听端口为9000 (
fastcgi_pass 127.0.0.1:9000;)，但实际PHP-FPM可能未运行或监听端口不正确。使用以下命令检查：-
进程查询：
ps -ef | grep php(查看PHP-FPM进程是否存在) -
端口查询：
netstat -anpt | grep php | grep listen(查看PHP-FPM监听端口)
如果端口或进程不符，需要调整PHP-FPM配置或重启PHP-FPM服务。
-
进程查询：
-
PHP-FPM配置错误或PHP代码错误： 如果以上检查没有问题，则需要进一步检查PHP-FPM的错误日志以及Nginx的
error.log，查找更详细的错误信息。 问题可能源于PHP-FPM自身配置错误或PHP代码错误。 -
文件权限问题： 确保Nginx用户对
/home/wwwroot/default/web目录及其子目录具有读取权限。 -
Nginx配置文件语法错误： 使用
nginx -t命令检查Nginx配置文件语法是否正确。
通过仔细检查日志文件和以上步骤，可以有效地定位并解决Nginx与PHP-FPM连接失败的问题。 记住，重启Nginx服务 (systemctl restart nginx 或 service nginx restart) 在修改配置文件后是必要的步骤。
