Nginx部署ThinkPHP路由失效的四大解决方案：一、推荐用try_files替代if；二、修正if中PATH_INFO传递；三、按TP5/6版本适配重写规则；四、解除open_basedir限制。
如果您在Nginx中部署ThinkPHP时发现路由失效、404错误或PATH_INFO无法识别，则很可能是由于Nginx配置中对请求的条件判断逻辑不兼容ThinkPHP的单入口与Pathinfo机制。以下是针对该问题的多种可操作配置方案：
一、使用try_files替代if判断（推荐）
nginx官方明确建议避免在location块中使用if指令处理请求重写，因其存在隐式行为和优先级陷阱；try_files指令更高效、更安全，且天然支持静态文件回退逻辑。该方式直接跳过文件存在性判断的分支歧义，确保所有非静态资源请求统一交由index.php处理。
1、打开Nginx站点配置文件（如/etc/nginx/conf.d/your-site.conf）。
2、将server块中的location /配置为：
location / {
root /var/www/your-project/public;
index index.php;
try_files $uri $uri/ /index.php?$query_string;
}
立即学习“PHP免费学习笔记（深入）”；
3、确保root路径精确指向ThinkPHP项目的public子目录。
4、保存后执行nginx -t验证语法，再执行nginx -s reload重载配置。
二、保留if判断但修正PATH_INFO传递
若因历史原因必须沿用if语句，则必须同步修复PHP-FPM环境变量缺失问题；仅重写URL而未正确设置fastcgi_param PATH_INFO，将导致ThinkPHP无法解析路由参数。此方案需在PHP处理块中显式拆分并注入PATH_INFO。
1、在location ~ \.php$块内添加fastcgi_split_path_info指令：
fastcgi_split_path_info ^(.+\.php)(/.+)$;
2、紧随其后设置以下三个关键参数：
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param SCRIPT_NAME $fastcgi_script_name;
fastcgi_param PATH_INFO $fastcgi_path_info;
3、确认fastcgi_pass指向正确的PHP-FPM监听地址（如127.0.0.1:9000或unix:/run/php/php-fpm.sock）。
4、删除原配置中可能存在的重复或冲突的if嵌套逻辑。
三、兼容ThinkPHP 5.x与6.x的混合重写规则
不同ThinkPHP版本对URL参数格式要求不同：5.x常用?s=形式，6.x默认启用pathinfo模式；单一if规则无法同时满足二者，需按版本选择对应重写目标。该方案通过正则匹配请求特征，动态适配入口参数格式。
1、对于ThinkPHP 5.x项目，在location /中使用：
if (!-e $request_filename) {
rewrite ^/(.*)$ /index.php?s=/$1 last;
}
2、对于ThinkPHP 6.x项目，在同一location /中改用：
if (!-e $request_filename) {
rewrite ^/(.*)$ /index.php/$1 last;
}
3、确保PHP处理块中已启用fastcgi_split_path_info并正确传递PATH_INFO。
4、在public/index.php同级目录下确认存在router.php且内容为标准ThinkPHP路由引导逻辑。
四、禁用open_basedir限制引发的if失效场景
当Nginx配置中启用了open_basedir但路径未覆盖ThinkPHP核心目录时，PHP在执行require语句时会因权限拒绝而中断，导致if判断后的重写逻辑根本未被执行；此时浏览器显示500错误而非404，实际是PHP层提前退出，Nginx的if规则形同虚设。该方案直击底层权限根源。
1、检查错误日志中是否出现“open_basedir restriction in effect”字样。
2、定位fastcgi_param PHP_ADMIN_VALUE所在行（通常在fastcgi.conf或站点配置中）。
3、将open_basedir值扩展为包含项目根目录及public目录：
fastcgi_param PHP_ADMIN_VALUE "open_basedir=/var/www/your-project:/var/www/your-project/public/:/tmp/:/proc/";
4、重启php-fpm服务使修改生效。
