ThinkPHP 6.1 路由绑定控制器失败主因是注册方式或路径写法错误：需显式写完整类名如'app\controller\User@read'，多应用须含子目录；路由文件须置于app/route/app.php或对应子应用目录；修改后需执行php think route:clear。
ThinkPHP 6.1 路由绑定控制器失败，90% 是因为没用对注册方式或路径写法不对——不是控制器不存在，而是框架根本没走到它那里。
Route::get() 等快捷方法必须配完整控制器路径
TP6.1 不再自动补全命名空间或目录前缀，Route::get('user','User/index') 这种写法只在单应用默认命名空间下有效；一旦用了多应用、自定义命名空间或 PSR-4 规则不一致，就会 404。
- 推荐显式写完整类名：
Route::get('user', 'app\controller\User@read') - 如果控制器在
app/controller/v2/User.php，必须写成'app\controller\v2\User@read'，不能省略v2\ - 类名末尾加
@method是必须的，漏掉（如只写'app\controller\User'）会报Class not found - 别依赖
use导入类后直接写类名——路由文件里use app\controller\User;+Route::get('u', User::class.'@index')才安全
route/app.php 位置和加载时机必须严格匹配
TP6.1 的路由加载是「按应用隔离」的，主应用和子应用的路由文件互不感知。哪怕你只改了 config/route.php，也完全不会影响实际路由解析。
- 单应用项目：路由必须写在
app/route/app.php，不是config/route.php或route/app.php - 多应用项目（如 admin、api）：每个子应用要单独维护
app/admin/route/app.php，且config/app.php中的app_route必须为true - 命令行执行
php think route:list默认不加载路由——得加--with-route参数，否则看到的永远是空列表 - 改完路由后必须运行
php think route:clear，否则缓存会掩盖所有修改
闭包路由无法绑定控制器，但能绕过路径解析限制
当你遇到控制器路径太复杂、需要动态判断模块或权限时，硬写控制器映射反而容易出错。这时候闭包路由不是“退而求其次”，而是更可控的选择。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
立即学习“PHP免费学习笔记（深入）”；
Route::get('api/:module/:id', function ($module, $id) { return (new \app\service\ApiService())->dispatch($module, $id); });- 闭包里可以手动 new 控制器、调用方法、甚至 throw 异常，完全跳过框架的路径解析逻辑
- 缺点是：无法被
url()反向生成、不支持中间件链式继承、调试时看不到路由列表 - 适合场景：API 网关层、租户动态模块加载、灰度路由分发
URL 中带斜杠的参数会截断，必须加正则约束
比如想传一个 Base64 编码的 token：/detail/eyJhbGciOi...，默认 :token 会停在第一个 / 就结束，导致后续段落无法匹配。
- 错误写法：
Route::get('detail/:token', 'Index/detail') - 正确写法：
Route::get('detail/:token', 'Index/detail')->pattern(['token' => '\S+']) -
\S+表示非空白字符任意长度，能吞掉 URL 中的斜杠；避免用.*，它会贪婪匹配到整个 URL 末尾 - 如果参数含中文，还要确认
config/route.php中url_html_suffix为false，否则.html后缀会干扰解码
真正难的不是写对一行 Route::get()，而是搞清当前请求走的是哪一层路由解析：是主应用？子应用？有没有被 domain 分组拦截？有没有被更宽泛的 Route::rule() 先匹配掉了？这些优先级问题，比语法本身更容易让人卡住。
