Linux Nginx配置后PHP页面无法访问，如何排查问题？-php教程-PHP中文网

Linux Nginx配置后PHP页面无法访问，如何排查问题？

心靈之曲

发布： 2025-03-02 18:04:00

原创

982人浏览过

linux nginx配置后php页面无法访问，如何排查问题？

Linux系统下Nginx与PHP-FPM配置故障排查指南

许多用户在配置Nginx和PHP-FPM协同工作时，会遇到Nginx配置完成后无法访问PHP页面，通常返回5xx错误码。本文将通过一个典型案例，分析可能原因并提供解决方案。

案例： 用户配置了如下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;
    }

    # ...其他配置...
}

登录后复制

排查步骤：

立即学习“PHP免费学习笔记（深入）”；

首先，检查Nginx日志文件（access.log和error.log），这些日志通常包含详细的错误信息，有助于快速定位问题。5xx错误，特别是502错误，通常表明上游服务器（PHP-FPM）出现问题。这可能意味着PHP-FPM服务未正常运行，或监听端口与Nginx配置不一致。

验证PHP-FPM状态：

在类Unix系统（如Ubuntu或CentOS）中，使用以下命令：

影像之匠PixPretty

商业级AI人像后期软件，专注于人像精修，色彩调节及批量图片编辑，支持Windows、Mac多平台使用。适用于写真、婚纱、旅拍、外景等批量修图场景。

299

查看详情

1. 进程查询：

ps -ef | grep php-fpm

登录后复制

此命令查看所有与PHP-FPM相关的进程，确认服务是否已启动。

2. 端口监听：

ss -tulnp | grep 9000

登录后复制

(使用 ss 命令代替过时的 netstat) 此命令查看PHP-FPM监听的端口，确认是否为Nginx配置文件中 fastcgi_pass 指令指定的9000端口。如果端口不一致或未监听该端口，则需检查PHP-FPM配置文件，确保其正确监听9000端口并已启动。

其他可能原因及解决方案：

PHP-FPM配置文件错误： 检查PHP-FPM配置文件（通常位于 /etc/php/7.4/fpm/pool.d/www.conf 或类似路径），确保 listen 指令和 listen.owner、listen.group、listen.mode 等参数配置正确。
文件权限问题： 确保Nginx用户对PHP文件及其所在目录具有读取权限。
Nginx配置文件语法错误： 使用 nginx -t 命令检查Nginx配置文件语法是否正确。
缺少必要的PHP扩展： 如果PHP脚本依赖某些扩展，确保已安装并启用。
SELinux或防火墙： 如果启用SELinux或防火墙，确保它们允许Nginx和PHP-FPM之间的通信。