ThinkPHP路由分组写法：prefix、middleware 和 miss 路由-ThinkPHP-PHP中文网

thinkphp路由分组中prefix、middleware和miss必须严格按位置和顺序调用：prefix须链式写在group()外；middleware推荐闭包方式确保参数传递；miss需显式定义且置于group链式末尾，否则前缀失效、中间件不触发、404不兜底。

thinkphp路由分组写法：prefix、middleware 和 miss 路由

ThinkPHP 路由分组不是简单套个括号，prefix、middleware 和 miss 必须按位置和调用顺序写对，否则前缀不生效、中间件不触发、404 页面也不走。尤其在 TP8 中，链式调用的执行时机和闭包作用域直接影响最终注册行为。

prefix 必须写在 group() 括号外，且不能嵌套在闭包里

错误写法（prefix 失效）：

Route::group('admin', function () {
    Route::get('index', 'Admin/Index/index');
})->prefix('v1'); // ✅ 正确：链式调用在闭包外

错误写法（prefix 被忽略）：

Route::group('admin', function () {
    Route::get('index', 'Admin/Index/index');
    ->prefix('v1'); // ❌ 语法错误，且 TP8 解析器直接跳过
});

正确效果是生成 /admin/v1/index；如果漏掉链式位置，实际注册的是 /admin/index，v1 前缀完全丢失。

Skill Weave Chains — 技能链路由引擎

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

下载

middleware 要传参就得用闭包方式，命名中间件带参数容易空

TP8 分组中间件解析发生在路由匹配前，命名中间件如 auth:admin 的参数可能无法传递到执行阶段。

推荐写法（闭包中间件，上下文完整）：

Route::group('admin', function () {
    Route::get('dashboard', 'Admin/Dashboard/index');
})->middleware(function ($request, $next) {
    if (!$request->session()->has('admin_login')) {
        return redirect('/admin/login');
    }
    return $next($request);
});

若坚持用命名中间件，确保构造方法支持从路由选项取值，而不是依赖 input() 或 session 初始态
调试时可加 dump($request->route()->getOptions()['middleware'] ?? []); 查看实际注入的中间件数组

miss 路由要分清全局和分组级，且必须显式定义

ThinkPHP 不自动提供 404 页面，miss 是手动兜底机制：

全局 MISS（所有未匹配路由都走这里）：

Route::miss('common/NotFound/index');

分组级 MISS（仅该分组内未匹配才触发）：

Route::group('api', function () {
    Route::get('users', 'Api/User@index');
    Route::post('login', 'Api/Auth@login');
})->miss('Api/NotFound/handle'); // 注意：这个 miss 只对 /api 下路径生效

注意：miss() 必须写在 group() 链式调用末尾，不能放在闭包内部，否则注册失败；控制器方法也需真实存在，返回响应或视图，不能只抛异常。

不复杂但容易忽略细节，写错一个位置就导致整组路由行为异常。