PHP文件在Nginx下无法执行的最常见原因是fastcgi_pass配置错误，需确保其与PHP-FPM监听地址（如/run/php/php8.1-fpm.sock或127.0.0.1:9000）严格匹配，并验证PHP-FPM运行状态、socket权限、SCRIPT_FILENAME参数及root路径是否正确。
PHP 文件在 Nginx 下无法执行，常见原因是 fastcgi_pass 配置错误，导致 PHP-FPM 服务未被正确转发。核心在于确保 Nginx 能连上 PHP-FPM 的监听地址（127.0.0.1:9000 或 /run/php/php8.1-fpm.sock），且权限、用户、路径均匹配。
确认 PHP-FPM 是否正在运行并监听正确地址
先检查 PHP-FPM 进程和监听配置：
- 运行
sudo systemctl status php8.1-fpm（版本按实际调整，如php7.4-fpm、php8.2-fpm）确认服务已启动 - 查看监听配置：
sudo cat /etc/php/8.1/fpm/pool.d/www.conf | grep -E "(listen|listen.owner|listen.group)" - 典型输出应为：
listen = /run/php/php8.1-fpm.socklisten.owner = www-datalisten.group = www-data - 若使用 TCP 模式（不推荐生产环境），应为：
listen = 127.0.0.1:9000，并确保listen.allowed_clients = 127.0.0.1
Nginx server 块中 fastcgi\_pass 必须与 PHP-FPM 监听方式严格一致
以下为完整、可直接使用的 Nginx 配置片段（以 Ubuntu + PHP 8.1 + Unix socket 为例）：
server {
listen 80;
server_name example.com;
root /var/www/html;
index index.php;
<pre class="brush:php;toolbar:false;">location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf; # 推荐复用官方片段
# 或手动配置（等效）：
# fastcgi_split_path_info ^(.+\.php)(/.+)$;
# fastcgi_index index.php;
# fastcgi_pass unix:/run/php/php8.1-fpm.sock;
# fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
# ✅ 关键：fastcgi_pass 必须与 php-fpm.conf 中的 listen 完全匹配
fastcgi_pass unix:/run/php/php8.1-fpm.sock;
# ✅ 确保用户组权限一致（www-data 是 Ubuntu/Debian 默认）
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param PATH_INFO $fastcgi_path_info;
}
location ~ /\.ht {
deny all;
}}
立即学习“PHP免费学习笔记（深入）”；
常见错误及修复对照表
遇到 502 Bad Gateway 或 “No input file specified” 时，按此排查：
-
socket 路径错误：如写成
/var/run/php/php8.1-fpm.sock，但实际路径是/run/php/php8.1-fpm.sock（/run是/var/run的符号链接，但部分系统需写绝对真实路径）→ 用ls -l /run/php/确认 -
权限不匹配：Nginx 工作用户（
www-data）无权读 socket 文件 → 检查ls -l /run/php/php8.1-fpm.sock，确保属主为www-data:www-data；否则修改www.conf中listen.owner和listen.group，再重启 PHP-FPM -
fastcgi_param SCRIPT_FILENAME 错误：若用
$realpath_root但未启用realpath_cache，或路径解析失败 → 改用更稳妥的$document_root$fastcgi_script_name -
PHP-FPM 未监听 IPv4（TCP 场景）：若
fastcgi_pass 127.0.0.1:9000但 FPM 只监听[::1]:9000→ 修改www.conf中listen = 127.0.0.1:9000并取消注释listen.allowed_clients
验证与热重载步骤
改完配置后务必顺序执行：
-
sudo nginx -t→ 检查语法是否正确 -
sudo systemctl reload nginx→ 重载配置（不中断服务） -
sudo systemctl restart php8.1-fpm→ 重启 PHP-FPM（尤其修改过其配置后） - 创建
/var/www/html/info.php，内容为<?php phpinfo(); ?>，浏览器访问测试
