ThinkPHP路由分组冲突源于配置继承未重置、子路由未引入、中间件参数丢失及定义顺序错误：需在分组闭包首行调用option()重置url_html_suffix等，用include_once或Route::import加载子文件，中间件改用闭包传参，静态路径须优先定义，allowCrossDomain()须链式调用在分组外。
ThinkPHP路由分组配置老是冲突，是因为分组默认继承全局配置却未显式重置关键项，子路由文件未被手动引入，中间件参数在链式调用中丢失，且路由定义顺序与变量约束不匹配——这些不是孤立问题，而是环环相扣的执行时序陷阱。
分组继承全局配置却不覆盖
打开 route/app.php，找到你写的 Route::group('api', function () { ... }); 闭包。
在闭包开头第一行，立即调用 option(['url_html_suffix' => '']) —— 不要省略这一步，【否则所有分组内路由都会自动追加 .html 后缀，哪怕你没在 config/route.php 里设】。
同理，若项目启用了域名绑定（如 url_domain_bind），必须同步重置：option(['url_domain_bind' => []])，否则分组路由可能跳转到错误域名。
立即学习“PHP免费学习笔记（深入）”；
别试图用 config('route.url_html_suffix', '') 动态修改——分组创建时已快照配置，后续改 config 完全无效。
子路由文件根本没被加载
方法一：在 route/app.php 最末尾添加一行：include_once __DIR__ . '/v1.php';
方法二：改用 Route::import()，例如在 route/app.php 中写 Route::import('api.v1', 'route.api.v1');，但注意第一个参数 'api.v1' 是唯一标识，重复 import 会后覆盖前。
【路径必须用 __DIR__，不能写 ./v1.php —— CLI 环境下工作目录不确定，相对路径必然失败】。
子文件 v1.php 内必须以 use think\facade\Route; 开头，且不能 return 或 exit，否则整个文件被跳过。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
中间件参数传不进去
第一步：确认你没写 middleware('auth:admin') 这种带拼接变量的字符串 —— 【middleware() 只接受字面量字符串，$role = 'admin'; middleware('auth:'.$role) 会直接失效】。
第二步：改用闭包中间件，在分组闭包内定义：middleware(function($request, $next) { $role = $request->route()->getRule() === 'admin/user' ? 'admin' : 'user'; return (new AuthMiddleware)->handle($request, $next, $role); });
第三步：调试时临时加 dump($request->route()->getOptions()['middleware'] ?? []); 查看实际注入的中间件数组，确认参数是否为空。
路由定义顺序引发隐性覆盖
① 把所有静态路径规则移到最前面，例如 Route::get('admin/login', 'Admin/Login/index');
② 接着放单变量规则，例如 Route::get('user/:id([0-9]+)', 'User/read'); —— 【括号内正则必须写，否则 :id 会吞掉 /edit 导致 user/123/edit 被截成 id=123/edit】。
③ 最后放通配符或嵌套变量，例如 Route::get('user/*', 'User/other');
Route::miss() 必须放在全部 Route::get/Route::post 之后，它只在所有已注册规则遍历完仍未匹配时才触发。
跨域配置写错位置导致 OPTIONS 卡死
在 Route::group('api/v1', function () { ... }) 的闭包结束后，立刻链式调用 ->allowCrossDomain(['https://localhost:3000'], true);
不要把 allowCrossDomain() 写进闭包内部，也不要漏掉最后的分号和括号 —— 写错位置会导致中间件未注入，浏览器预检请求直接超时。
若仍失败，手动建 CorsMiddleware 中间件，在 handle() 方法开头判断 if ($request->isOptions()) { return response('', 204)->header(...); } —— 【header() 必须在任何输出之前执行，echo 或 var_dump 都会触发 Cannot modify header 错误】。
