Nginx未正确传递PATH_INFO导致TP5的U()生成URL缺失index.php或参数错乱；需在Nginx配置中添加fastcgi_split_path_info、PATH_INFO和SCRIPT_FILENAME三处设置，并在TP配置中设'url_domain_root' => '/index.php'强制补全入口。
U() 方法在 phpEnv + Nginx 环境下生成的 URL 缺失 index.php 或参数错乱，不是 TP 代码写错了，是 Nginx 没把 PATH_INFO 正确传给 PHP —— 尤其当项目沿用 TP5 的 U('User/login') 写法、又没开路由别名时，问题会集中爆发。
为什么 Nginx 下 U() 生成的 URL 总是少 index.php 或变成 query 参数？
TP5 的 U() 默认依赖 PATH_INFO 环境变量来判断当前请求路径结构，从而决定是否补 index.php、怎么拼参数。但 Nginx 默认不设置 PATH_INFO，PHP-FPM 收到的是空或错误值，U() 就只能退化成普通模式（?m=xxx&a=yyy）或直接返回空路径。
常见现象包括：
-
U('User/login')输出/User/login（缺index.php，Nginx 404） -
U('User/profile', ['id' => 123])输出/User/profile?id=123（本该是/index.php/User/profile/id/123） - 开启 REWRITE 模式后，模板链接全挂，但手动访问
/index.php/User/login反而能进
Nginx 配置必须补上的三处关键点
phpEnv 的 Nginx 配置文件（通常是 /phpenv/nginx/conf/vhost/xxx.conf）里，需在 location ~ \.php$ 块中显式注入 PATH_INFO，并确保入口文件识别正确：
立即学习“PHP免费学习笔记（深入）”；
- 删掉原配置中可能存在的
fastcgi_param SCRIPT_FILENAME重复定义 - 必须添加：
fastcgi_param PATH_INFO $fastcgi_path_info; - 必须添加：
fastcgi_split_path_info ^(.+\.php)(/.+)$;（放在fastcgi_param之前） -
SCRIPT_FILENAME要用绝对路径，例如：fastcgi_param SCRIPT_FILENAME /phpenv/www/your-project/public$fastcgi_script_name;
完整片段示例（仅关键部分）：
location ~ \.php$ {
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_param PATH_INFO $fastcgi_path_info;
fastcgi_param SCRIPT_FILENAME /phpenv/www/your-project/public$fastcgi_script_name;
include fastcgi_params;
fastcgi_pass 127.0.0.1:9000;
}
ThinkPHP 配置要同步关掉“自动剥离 index.php”逻辑
TP6 默认假设 Web 服务器已做重写、index.php 不可见，所以它会在生成 URL 时主动省略。但 phpEnv + Nginx 默认没配重写规则，这时候必须让 TP “认怂”，老老实实带上 index.php：
- 在
config/app.php中设：'url_html_suffix' => '',（避免后缀干扰） - 设：
'url_common_param' => true,（允许普通参数模式 fallback） - 设：
'url_route_must' => false,（防止路由匹配失败直接中断） - 最关键：设：
'url_domain_root' => '/index.php',（强制所有U()输出以/index.php开头）
注意：url_domain_root 不是官方文档常提的配置项，但它在 TP5 兼容层实际生效 —— 它会覆盖 U() 内部的入口推导逻辑。
别指望 U() 自动适配新路由规则
一旦你启用了 ThinkPHP 6 的命名路由（Route::get(...)->name('user.login')），U() 就完全不走旧逻辑了。它不会尝试反向匹配路径规则，只查 name() 注册表。
- 老项目混用路由和
U()，必须全局搜索U(，把所有需要路由支持的调用替换成url('user.login', [...]) -
U('user/login')和url('user.login')是两套系统，不能交叉使用 - 闭包路由、资源路由即使加了
->name()，url()也可能返回空 —— 这不是 bug，是设计限制，别硬塞
最稳妥的过渡方式：保留 U() 仅用于无参跳转（如 U('Index/index')），所有带参或需伪静态的链接，全部切到命名路由 + url()。
