ThinkPHP6.1如何绑定控制器_ThinkPHP6.1路由映射【配置】-ThinkPHP-PHP中文网

thinkphp 6.1 路由绑定控制器失败主因是注册方式或路径写法错误：需显式写完整类名如'app\controller\user@read'，多应用须含子目录；路由文件须置于app/route/app.php或对应子应用目录；修改后需执行php think route:clear。

thinkphp6.1如何绑定控制器_thinkphp6.1路由映射【配置】

ThinkPHP 6.1 路由绑定控制器失败，90% 是因为没用对注册方式或路径写法不对——不是控制器不存在，而是框架根本没走到它那里。

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') 才安全

TP6.1 的路由加载是「按应用隔离」的，主应用和子应用的路由文件互不感知。哪怕你只改了 config/route.php，也完全不会影响实际路由解析。

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

下载

单应用项目：路由必须写在 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，否则缓存会掩盖所有修改

当你遇到控制器路径太复杂、需要动态判断模块或权限时，硬写控制器映射反而容易出错。这时候闭包路由不是“退而求其次”，而是更可控的选择。

Route::get('api/:module/:id', function ($module, $id) { return (new \app\service\ApiService())->dispatch($module, $id); });
闭包里可以手动 new 控制器、调用方法、甚至 throw 异常，完全跳过框架的路径解析逻辑
缺点是：无法被 url() 反向生成、不支持中间件链式继承、调试时看不到路由列表
适合场景：API 网关层、租户动态模块加载、灰度路由分发

比如想传一个 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 后缀会干扰解码