ThinkPHP 6 路由别名不生效是因为默认关闭 route_alias 配置、未显式调用 name() 方法、参数名不匹配、分组别名未手动继承四类问题；需在 config/route.php 中设置 'route_alias' => true，并确保每个路由都调用 ->name('xxx')，且变量名与路由定义严格一致。
ThinkPHP 6 路由别名不生效，不是写法错了，而是默认关闭了别名映射功能。老项目从 TP5 升级后，url('admin') 或 url('index/index') 直接返回空或报错，本质是配置未开、命名缺失、参数不匹配三类问题叠加导致。
必须启用 route_alias 配置
TP6 默认禁用路由别名反解，即使写了 ->name('admin')，url() 也不会识别。需在 config/route.php 中显式开启：
- 添加配置项：
'route_alias' => true - 该配置只对路由系统生效，不影响中间件或模板渲染
- 若使用多应用（如
app/admin/），每个子应用的config/route.php都要单独设置
所有目标路由必须显式调用 name()
别名不是自动推导的，也不是路径转义来的。哪怕路径完全匹配，没调用 name() 就无法被 url() 反向生成：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 正确写法：
Route::get('admin', 'Admin/Index/index')->name('admin') - 错误写法：
Route::get('admin', 'Admin/Index/index')（无 name，url('admin')必然失败） - 别名只能是纯字符串，不能含
/、.、空格；重复命名时后注册的会覆盖前一个
数组参数必须严格对应命名变量
TP6 的 url('user.read', ['id' => 123]) 能生成 /user/123，前提是路由定义中用了占位符且变量名一致：
立即学习“PHP免费学习笔记（深入）”；
- 路由必须定义为：
Route::get('user/:id', 'User/read')->name('user.read') - 如果写成
Route::get('user/:uid', ...)->name('user.read')，传['id' => 123]就无效 - 想生成带查询参数的 URL（如
/user/profile?id=123），得显式加['query' => ['id' => 123]]，且路由名必须存在
分组别名需手动继承，不会自动拼接
TP5 支持分组设置前缀别名（如 ->name('api.')），TP6 表面兼容但逻辑收紧：
- 父组写了
->name('v1.')，子路由必须自己调用->name('user.index')，最终别名才是v1.user.index - 若子路由漏掉
name()，它就彻底无别名，url('v1.user.index')返回空字符串，且框架不报错 - 建议升级时全局搜索
->name(，确认每个需反解的路由都有完整、唯一、非空的别名
