悠悠楠杉
网站页面
NGINX配置导致PHP网站跳转404错误的终极解决方案
12/14
正文：
遇到PHP网站突然跳转404错误，而静态页面却正常访问？八成是NGINX配置出了问题。作为最常用的高性能Web服务器，NGINX的灵活配置是一把双刃剑——稍有不慎就会让动态页面“消失”。本文将带你直击问题根源，手把手修复这类“幽灵404”。
一、为什么NGINX会“吃掉”PHP请求？
404错误的本质是服务器找不到资源，但PHP文件明明存在，问题通常出在以下环节：
1. FastCGI未正确传递请求：PHP通过FastCGI处理，若NGINX未将请求转发给PHP-FPM，直接返回404。
2. 路径重写规则冲突：如try_files指令误判动态请求为静态文件。
3. SCRIPT_FILENAME参数缺失：FastCGI需要完整文件路径，否则PHP-FPM无法定位脚本。
二、5种核心解决方案（附代码）
1. 检查FastCGI基础配置
确保NGINX能正确转发PHP请求到后端，关键配置如下：
location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000; # PHP-FPM监听地址
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}注意：SCRIPT_FILENAME必须包含$document_root（如/var/www/html），否则PHP-FPM会收到不完整路径。
2. 修复try_files指令误判
常见错误配置会强制检查静态文件是否存在：
location / {
try_files $uri $uri/ =404; # 直接拦截未找到的PHP请求
}修正方案：在PHP的location块中移除try_files，或增加例外：
location ~ \.php$ {
try_files $uri =404; # 仅检查PHP文件是否存在
# 其他FastCGI配置...
}3. 处理PATH_INFO导致的404
某些框架（如CodeIgniter）使用PATH_INFO时，需额外配置：
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_param PATH_INFO $fastcgi_path_info;4. 验证PHP-FPM工作状态
执行命令检查PHP-FPM是否监听：
netstat -tulnp | grep 9000 # 确认端口活跃
systemctl status php-fpm # 检查服务状态5. 日志诊断法
通过NGINX和PHP-FPM日志精准定位问题：
- NGINX错误日志：/var/log/nginx/error.log
- PHP-FPM日志：/var/log/php-fpm.log
常见日志线索：log
2024/02/20 10:00:00 [error] 1234#0: *1 FastCGI sent in stderr: "Unable to open primary script: /wrong/path/index.php"
三、防坑指南
- 避免混合使用Apache规则：如.htaccess重写规则需转换为NGINX语法。
- 注意SELinux/Firewall：临时关闭测试
setenforce 0，确认是否为权限拦截。 - 缓存干扰：测试时禁用浏览器缓存或NGINX代理缓存。
通过以上步骤，90%的NGINX+PHP 404问题可快速解决。若问题依旧，建议使用curl -I URL检查HTTP响应头，进一步分析请求链路。
