Nginx try_files指令对带参数PHP文件失效问题排查求助

我有一个从web.archive.org恢复的纯静态网站，想通过Nginx的try_files指令实现：形如xxx?q=1的请求，完全按照文件系统中存储的对应文件打开。目前除.php后缀的文件（例如aaa.php?q=1）外，其余请求均正常工作，但此类带参数的PHP请求都会直接加载aaa.php文件。

使用的虚拟主机配置代码如下：

server {
    server_name xxx.kz;
    root /mnt/data/web/www;
    error_log /mnt/data/web//logs/error.log error;
    
    location / {
        try_files $uri $request_uri $request_uri/index.html =404;
        error_page 404 http://$host/;
    }

    location ~* \.php$ {
        types { } default_type text/html;
    }
}

错误原因与修复方案 #

错误原因 #

• Nginx的location匹配优先级是正则location优先于普通location。你配置中单独定义的location ~* \.php$正则块会拦截所有带.php后缀的请求，导致这些请求不会进入主location /执行try_files逻辑。
• 在.php的location块中，仅设置了返回类型，但未处理请求参数，所以Nginx只会尝试加载文件系统中的aaa.php文件，不会匹配带参数的路径（比如aaa.php?q=1对应的实体文件）。

修复方案 #

方案一：移除单独的.php location块（推荐）

由于网站是纯静态的，不需要处理动态PHP逻辑，直接删除这个正则location块，让所有请求统一走主location的try_files规则即可：

server {
    server_name xxx.kz;
    root /mnt/data/web/www;
    error_log /mnt/data/web//logs/error.log error;
    
    location / {
        try_files $uri $request_uri $request_uri/index.html =404;
        error_page 404 http://$host/;
        types { } default_type text/html;
    }
}

方案二：在.php location块中添加try_files

如果必须保留.php的单独配置，在该块内添加与主location一致的try_files规则，确保带参数的请求能被正确匹配：

server {
    server_name xxx.kz;
    root /mnt/data/web/www;
    error_log /mnt/data/web//logs/error.log error;
    
    location / {
        try_files $uri $request_uri $request_uri/index.html =404;
        error_page 404 http://$host/;
    }

    location ~* \.php$ {
        try_files $uri $request_uri $request_uri/index.html =404;
        error_page 404 http://$host/;
        types { } default_type text/html;
    }
}

内容的提问来源于stack exchange，提问作者Artyom Tarakanov