Nginx+Slim路由配置问题：新API特定路径404排查求助

我一眼就看出问题出在**location ~ /api/lib/(\w+)/块的try_files和FastCGI参数配置上**，结合Slim框架的路由机制，咱们一步步拆解：

核心问题原因 #

当你访问localhost/api/lib/v1/getUser/时：

1. Nginx匹配到location ~ /api/lib/(\w+)/块，此时$1的值是v1
2. try_files $uri $uri/ /api2.php?$args这一步有两个关键错误：
   • 最后重写的/api2.php是根目录路径，但你的api2.php实际在/api/lib/v1/下，路径完全不对
   • 即使路径写对了，$fastcgi_script_name会被设置为请求的路由路径/api/lib/v1/getUser，而非真正的脚本文件api2.php，导致SCRIPT_FILENAME变成rootDir/api/lib/v1/getUser——这是个不存在的文件，自然返回404

而访问localhost/api/lib/v1/时能正常工作，是因为此时$uri就是/api/lib/v1/，try_files会触发fastcgi_index api2.php规则，自动找到目录下的脚本，所以$fastcgi_script_name正确指向了api2.php。

修复后的配置 #

把location ~ /api/lib/(\w+)/块修改成这样：

location ~ ^/api/lib/(\w+)/ {
    include fastcgi_params;
    # 重写所有路由到对应版本的api2.php，利用捕获组$1动态匹配版本号
    try_files $uri $uri/ /api/lib/$1/api2.php?$args;
    # 直接指定脚本文件的绝对路径，避免$fastcgi_script_name的错误指向
    fastcgi_param SCRIPT_FILENAME $document_root/api/lib/$1/api2.php;
    fastcgi_param SCRIPT_NAME /api/lib/$1/api2.php;
    # 保留请求参数，确保Slim能正常接收GET参数
    fastcgi_param QUERY_STRING $args;
    fastcgi_pass unix:/run/php/php7.0-fpm.sock;
}

关键调整点说明 #

• 修改location匹配规则为^/api/lib/(\w+)/，确保从路径开头就精准匹配，避免意外匹配其他无关子路径
• try_files的最后重写路径改为/api/lib/$1/api2.php?$args，用捕获组$1动态对应v1这类版本号，保证脚本路径正确
• 直接硬编码SCRIPT_FILENAME和SCRIPT_NAME为正确的脚本路径：Slim框架只需要知道入口脚本位置，路由信息会通过REQUEST_URI自动解析，不需要让FastCGI感知具体的路由路径
• 额外保留QUERY_STRING，确保请求携带的GET参数能正常传递到Slim处理

另外，建议你把location ~ \.php$块的fastcgi_index api1.php改成index.php，避免非api1的PHP文件被错误指向api1.php，不过这不是当前404问题的核心。

内容的提问来源于stack exchange，提问作者A.C_GSXR