nginx未正确转发php请求至fastcgi是导致php页面空白、下载源码或报500/404/502错误的主因，需依次排查php识别配置、php-fpm服务状态、nginx配置语法、文件权限与索引设置，并通过错误日志精确定位问题。
如果您在网页中嵌入 PHP 链接（如通过 <?php include 'file.php'; ?> 或直接访问 .php 资源）时失败，页面显示空白、下载源码、返回 500/404/502 错误，或提示“File not found”，则极大概率是 Nginx 未正确将 PHP 请求转发给 FastCGI 处理器。以下是针对性排查与修复步骤：
一、验证 PHP 文件是否被 Nginx 正确识别为可执行脚本
该步骤确保 Nginx 的 location ~ \.php$ 块存在且生效，避免 PHP 文件被当作静态文件直接返回源码。
1、打开 Nginx 主配置文件或站点配置文件（如 /etc/nginx/sites-enabled/your-site.conf 或 /usr/local/nginx/conf/nginx.conf）。
2、查找是否存在匹配 PHP 后缀的 location 块，典型结构应包含 fastcgi_pass 指令，例如：
立即学习“PHP免费学习笔记（深入）”；
location ~ \.php$ { fastcgi_pass unix:/run/php-fpm/www.sock; ... }
3、若缺失该块，或被注释、被错误的正则覆盖（如 location / { try_files $uri $uri/ =404; } 无 fallback 到 PHP），需补充或修正。
4、确认该 location 块未被更高优先级的 location（如 location = /index.php）意外截断，且未遗漏 include fastcgi_params; 或 include snippets/fastcgi-php.conf;。
二、检查 FastCGI 后端服务是否就绪并可通信
该步骤排除 PHP-FPM 进程未运行、监听地址不匹配或权限拒绝等底层连接问题。
1、执行命令检查 PHP-FPM 服务状态：sudo systemctl status php-fpm 或 sudo systemctl status php7.4-fpm（依版本而定）。
2、若服务未运行，启动它：sudo systemctl start php-fpm；并设为开机自启：sudo systemctl enable php-fpm。
3、确认 PHP-FPM 监听地址与 Nginx 中 fastcgi_pass 值一致：查看 /etc/php/*/fpm/pool.d/www.conf 中 listen = 行，比对是否为 unix:/run/php-fpm/www.sock 或 127.0.0.1:9000。
4、若使用 Unix socket，检查 socket 文件权限和属主：ls -l /run/php-fpm/www.sock，确保 Nginx 工作用户（如 www-data 或 nginx）有读写权限；若为 TCP，检查防火墙是否放行 9000 端口。
三、校验 Nginx 配置语法及重载服务
该步骤防止因配置保存后未生效或存在隐藏语法错误导致 PHP 解析完全失效。
1、执行配置语法检测：sudo nginx -t。
2、若提示 syntax is ok 且 test is successful，继续下一步；否则根据错误行号修正配置（常见错误：括号不闭合、分号遗漏、路径含中文或空格）。
3、执行重载而非重启：sudo nginx -s reload 或 sudo systemctl reload nginx，避免请求中断。
4、验证重载后进程是否更新：ps aux | grep nginx，确认 master 进程启动时间已刷新。
四、排查文件权限与根目录索引设置
该步骤解决因权限不足或索引顺序错误导致 PHP 入口无法触发的问题。
1、确认 Nginx 配置中 root 指向的目录真实存在，且包含目标 PHP 文件（如 index.php）。
2、检查该目录及所有上级目录对 Nginx 用户具备执行权限（x）：namei -l /var/www/html，确保每级路径中 Nginx 用户有 --x 权限。
3、确认 index 指令中 index.php 排在 index.html 之前：index index.php index.html index.htm;。
4、测试最小化 PHP 输出：在站点根目录新建 info.php，内容为 <?php phpinfo(); ?>，浏览器访问 http://yoursite/info.php；若仍失败，说明上述任一环节未通。
五、启用并分析错误日志定位具体失败点
该步骤借助日志输出精准识别失败类型（如 connect refused、permission denied、no input file specified）。
1、确保 Nginx 配置中已开启详细错误日志：error_log /var/log/nginx/error.log warn;（级别至少为 warn 或 error）。
2、复现问题（如刷新 PHP 页面），立即执行：sudo tail -n 20 /var/log/nginx/error.log。
3、重点识别以下关键词：
"No input file specified" → fastcgi_param SCRIPT_FILENAME 路径拼接错误，需核对 $document_root$fastcgi_script_name 是否指向真实文件；
"Connection refused" → fastcgi_pass 地址不可达，PHP-FPM 未运行或监听地址不一致；
"Permission denied" → Nginx 用户无权访问 PHP 文件或 socket 文件；
"Primary script unknown" → root 路径配置错误或 SCRIPT_FILENAME 变量未正确传递。
