ThinkPHP路由不生效主因是未开启app_route开关、路由文件位置错误、缓存未清除或Route类未引入；需确认config/app.php中'app_route' => true（布尔值），路由文件置于app/route/app.php并use think\facade\Route，TP6/8中可选参数须写为user[/:id]，开启url_route_must后必须显式定义根路由。

ThinkPHP路由规则写完不生效，90% 是因为没打开开关、文件放错位置、缓存没清，或者 Route 类根本没引入。不是语法问题，而是执行链断在了第一步。

确认 app_route 开关已启用

ThinkPHP 6/8 默认关闭路由解析，即使你写了 Route::get()，框架也直接跳过——它根本不会去读你的路由文件。

• 打开 config/app.php，检查是否存在且值为布尔 true 的 'app_route' => true
• 多应用模式下（如 app/admin），必须单独检查该子应用下的 config/app.php，主应用配置不继承
• 别写成 'app_route' => "true" 或 'app_route' => 1，PHP 类型必须是 bool
• 改完后务必运行 php think route:clear 清除已编译的路由缓存

路由文件必须放在正确路径 + 正确引入 Route

ThinkPHP 6+ 不再从 config/route.php 加载规则，那里只管行为开关（比如 url_route_must），不承载映射逻辑。

• 单应用：路由规则必须写在 app/route/app.php（不是 route/app.php，也不是 config/route.php）
• 多应用：比如 admin 子应用，必须写在 app/admin/route/app.php
• 每个路由文件顶部第一行必须有 use think\facade\Route;，缺了就报 Class 'Route' not found
• 别在 config/route.php 里写 Route::get()，那部分代码会被完全忽略

动态参数和可选段写法要严格匹配版本

ThinkPHP 5 和 6/8 对 :id 和 [:id] 的处理逻辑不同，混用会导致 404，但错误提示极不明显。

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

立即学习“PHP免费学习笔记（深入）”；

• TP6/8 中：user/:id 表示 :id 必填；user[/:id] 才表示可选（注意方括号包住整个 /:id）
• TP5 中：user/:id 同样必填，但可选写法是 user/[:id]（方括号只包变量名）
• 多个可选段不要嵌套：user[/:id[/:name]] 在 TP6 下可能匹配失败，建议拆成两条独立路由
• 正则约束必须加在参数后：user/:id\d+，而不是 user/:id + 单独传 pattern 数组（快捷方法不支持）

强制路由开启后首页必须显式定义

设了 'url_route_must' => true 却没配根路径，打开域名直接 404，很多人以为是路由崩了，其实是漏写了最基础的一条。

• 必须在路由文件中加一句：Route::get('/', 'index/index');
• 如果用了多应用，且想让 / 指向 admin，则写 Route::get('/', 'admin/index/index');
• 全局未命中处理建议加上：Route::miss(function() { return view('404'); });，避免裸奔报错
• 别依赖 Route::any() 来兜底——它会绕过请求方法校验，调试时难以定位是 GET 还是 POST 出问题

最容易被忽略的是：改了路由文件后没清缓存，或者多应用下只改了主应用的 app.php 却忘了子应用也有自己的路由文件。TP 的路由加载是静态扫描 + 编译缓存的，不是每次请求都重读 PHP 文件。