Nginx+PHP动态页面404问题排查与解决

1. 问题背景与现象描述

最近在将服务器环境从宝塔面板7.0升级到8.5版本时，遇到了一个典型的Nginx+PHP动态页面404报错问题。具体环境配置为Nginx作为Web服务器，PHP作为动态脚本处理器，MySQL 5.7作为数据库后端。

升级完成后，访问所有.php后缀的动态页面时，Nginx直接返回404 Not Found错误，而静态资源（如HTML、CSS、JS文件）却能正常加载。这种症状表明Nginx未能正确将PHP请求传递给PHP-FPM处理，而是直接尝试在文件系统中查找对应的.php文件（当然找不到）。

提示：当遇到动态页面404而静态资源正常的情况，90%的问题都出在Nginx与PHP-FPM的通信配置上。

2. 问题排查与原因分析

2.1 配置文件对比分析

通过对比宝塔7.0和8.5生成的Nginx配置文件，发现了几个关键差异点：

1. 字符集设置缺失：8.5版本的默认配置中移除了charset utf-8;指令
2. MIME类型包含路径：7.0版本明确包含了mime.types文件
3. PHP处理逻辑：8.5版本的location ~ \.php$块配置有细微调整

2.2 根本原因定位

经过反复测试，确认问题主要由以下因素导致：

1. 字符集设置影响：缺少charset utf-8;会导致Nginx在处理请求时可能错误解析URL路径
2. PHP处理器配置：新版本的fastcgi_pass指令参数格式有变化
3. 路径解析问题：SCRIPT_FILENAME参数未正确指向PHP文件实际路径

3. 完整解决方案

3.1 修复Nginx主配置文件

在nginx.conf的http块中添加字符集设置：

nginx复制http {
    include mime.types;
    #include luawaf.conf;
    include proxy.conf;
    default_type application/octet-stream;
    charset utf-8;  # 关键修复项
    server_names_hash_bucket_size 512;