ThinkPHP 6 路由中间件绑定失败主因是注册方式、调用时机、作用域范围三者不匹配：必须显式链式调用 middleware()，分组不自动继承，中间件名须与配置键名严格一致，资源路由需通过分组或控制器构造方法绑定。
路由级中间件必须显式调用 middleware()
Route::get('user', 'User/index') 这样写，哪怕你配置了 auth 中间件，也不会自动触发。
正确写法是链式追加：->middleware('auth')：
- ✅ Route::get('user', 'User/index')->middleware('auth')
- ✅ Route::resource('posts', 'Post')->middleware(['auth', 'check'])
- ❌ Route::get('user', 'User/index'); // 没 middleware()，中间件不执行
- ❌ Route::get('user', 'User/index')->middleware('auth')->allowCrossDomain(); // allowCrossDomain() 是 TP6.1+ 方法，但不能和 middleware() 混在一条链里干扰解析
分组路由中间件不会自动继承
Route::group('api', function () { Route::get('user', 'User/index'); }) 不会自动套用外层中间件；嵌套分组更不会“继承”父级中间件。
必须在每个需要保护的分组里单独绑定：
立即学习“PHP免费学习笔记（深入）”；
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- ✅ Route::group('api', function () { Route::get('user', 'User/index'); })->middleware('auth')
- ✅ Route::group('admin/user', function () { ... })->middleware('role:admin')
- ❌ Route::group('admin', function () { Route::group('user', ...); })->middleware('auth'); // 内层 group 不受保护
中间件名要和配置键名完全一致
app/middleware.php 或 config/middleware.php 里注册的是 'auth' => \app\middleware\Auth::class，那路由里就必须写 'auth'，不能写 'Auth'、'auth_middleware' 或类全名。
大小写、拼写、别名都要严丝合缝：
- ✅ middleware('auth')
- ✅ middleware(['auth', 'throttle:60,1']) // 字符串形式仅限内置支持的中间件
- ❌ middleware('Auth')
- ❌ middleware(\app\middleware\Auth::class) // 路由层不支持直接传类，除非你手动绑定了别名
资源路由不能链式调用 middleware()
Route::resource('users', 'Api/User')->middleware('auth') 会报错：ResourceRoute 实例不支持该方法。
正确做法只有两种：
- ✅ 放进分组里统一绑定：Route::group('api', function () { Route::resource('users', 'Api/User'); })->middleware('auth');
- ✅ 在控制器构造方法中定义：$this->middleware('auth')->except(['index', 'show']);
