ThinkPHP路由分组绑定中间件必须链式调用middleware()且写在Route::group()之后、闭包之前；域名绑定必须用Route::domain()并定义在route/app.php或route/domain.php中，开启url_domain_deploy配置。
ThinkPHP路由分组绑定中间件必须链式调用middleware()
中间件不会自动继承到分组内，->middleware('auth')必须写在Route::group()之后、闭包之前，否则只对某一条子路由生效，甚至完全不执行。
- ✅ 正确写法：
Route::group('admin', function () { Route::get('user', 'Admin/User/index'); })->middleware('auth'); - ❌ 错误写法：
Route::group('admin', function () { Route::get('user', 'Admin/User/index')->middleware('auth'); });——这只绑定了user路由，admin分组下其他路由不受影响 - ⚠️ 中间件名必须和
config/middleware.php中aliases数组的键完全一致，大小写、下划线都不能错，比如配置里是'checkRole' => \app\middleware\CheckRole::class，就不能传'check_role' - 多个中间件按顺序执行，传数组即可：
->middleware(['auth', 'throttle', 'log'])
域名绑定必须用Route::domain()且写在route/app.php中
Route::domain()只能在route/app.php里定义才生效，写在config/route.php、中间件或控制器里完全无效；它不是“识别域名”，而是创建独立路由空间。
- ✅ 正确位置：打开
route/app.php，写Route::domain('admin.example.com', function () { Route::get('index', 'Admin/Index/index'); }); - ❌ 常见错误：把域名判断逻辑塞进
app/middleware.php，这只会读取Host头，但无法让url()生成带域名的链接，也无法触发路由匹配 - 第二参数必须是闭包或数组，不能是字符串路径，
Route::domain('api.example.com', 'Api/Index/index')会直接报Invalid route rule - 本地开发时注意
HTTP_HOST含端口（如localhost:8000），需匹配完整，否则路由不命中
分组+域名组合使用时，中间件与前缀要各自显式挂载
一个域名分组里可以再套路由分组，但prefix()和middleware()都只作用于直接包裹的闭包，嵌套分组不会自动继承外层设置。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
-
Route::domain('admin.example.com', function () { Route::group('user', function () { Route::get('list', 'User/list'); })->middleware('role:user'); })->middleware('auth');——这里auth只对domain闭包内**未被子分组包裹**的路由生效，user分组里的list只走role:user - 若需叠加，得手动重复写：
->middleware(['auth', 'role:user'])，或改用统一前缀+控制器内中间件细化控制 -
prefix()和middleware()位置固定：都在闭包前，顺序无关，但必须链式调用；->prefix('v1')->middleware('cors')和->middleware('cors')->prefix('v1')效果一样 - 前缀会自动规整斜杠：
prefix('/api/')、prefix('api')最终都变成/api，子路由路径相对于它拼接
多应用模式下二级域名绑定要配url_domain_deploy并require模块路由
TP6/8 不支持模块自动绑定域名，必须开启url_domain_deploy，并在route/domain.php中用Route::domain() + require显式加载对应模块路由文件。
立即学习“PHP免费学习笔记（深入）”；
- 确认
config/app.php中'url_domain_deploy' => true已开启（默认开启，但务必检查） - 所有域名路由定义必须集中放在
route/domain.php，不能散落在各模块自己的route.php里 - 写法示例：
Route::domain('api.example.com')->group(function () { require __DIR__ . '/api.php'; });，其中api.php里定义Route::get('v1/user', ...)等规则 - 不要在
Route::domain()闭包里直接写大量路由，否则难以复用模块内已有的Route::resource()等复杂定义，也容易和require的文件冲突
url_domain_deploy开关——前者导致鉴权静默失效，后者导致域名路由完全不触发，连404都不会报，只会 fallback 到默认路由。 
