路由冲突源于匹配顺序、作用域隔离与约束叠加：域名/分组/HTTP方法任一不匹配即失效，动态参数须置于静态路由后，缓存未清会导致旧规则残留。
路由规则冲突不是“写多了就打架”，而是匹配顺序和作用域叠加导致后注册的规则被前一条吃掉，或者域名/分组/HTTP方法三重约束下某条根本没机会执行。
Route::domain() 闭包里漏写了路由
Route::domain() 是独立作用域，不是“继承+追加”。你在全局写了 Route::get('user/:id', 'User/read')，又在 Route::domain('api.example.com', function () {}) 里什么都没写——那 api 域名下所有请求都直接 404，因为框架压根不会去查全局路由。
- 必须把该域名下所有需要的路由，全部重新写进闭包里，包括 Route::get()、Route::post()、Route::resource()，不能只 copy-paste 全局规则然后套个壳
- 闭包参数是
$route对象，别在里面写Route::get()，要写$route->get()，否则静态调用会注册到全局，不生效于当前域名 - 泛域名
Route::domain('*')优先级高于未绑定域名的规则，但它的闭包里也必须显式声明$route->get()，否则照样不匹配
Route::group() 前缀不匹配导致整组失效
比如你写了 Route::group(['prefix' => 'admin'], function () { Route::get('user', 'Admin/User/index'); });，但访问的是 /user 或 /backend/user，那这条规则从头到尾都不会参与匹配——它只响应 /admin/user。
- 检查实际请求 URL 路径是否严格以 group 的
prefix开头（注意开头斜杠、大小写、有无 trailing slash） - 多个嵌套 group 时，prefix 是拼接的：
Route::group(['prefix'=>'v1'], function() { Route::group(['prefix'=>'api'], function() { ... }); });匹配的是/v1/api/xxx - 不要在 group 外部再写同路径的
Route::get('admin/user', ...)，它和 group 内的'user'是两条不同规则，可能因注册顺序造成覆盖
HTTP 方法不匹配让路由“隐身”
Route::get('submit', 'Form/handle') 对 POST 请求完全无效，但错误提示仍是「找不到路由」，容易误判为路径问题。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
立即学习“PHP免费学习笔记（深入）”；
- 用
php think route:list查看输出中的 Method 列，确认目标路由的 Method 是否与你发起的请求一致（GET/POST/PUT/DELETE） - 避免混用
Route::rule()和语义化方法：前者默认接受所有方法，后者强制校验；如果已有Route::rule('submit', ...)，再写Route::post('submit', ...)，后者会被前者先命中而忽略方法约束 - 调试时用 curl 显式指定方法：
curl -X POST http://localhost/submit，比浏览器刷新更可控
路由注册顺序影响最终匹配结果
ThinkPHP 按代码执行顺序逐条匹配，一旦命中就停止。所以 Route::get('user/:id', ...) 必须放在 Route::get('user/list', ...) 前面，否则 /user/list 会被当成 :id = 'list' 先匹配走。
- 动态参数路由（含
:id、:name?）应放在静态路径路由之后，否则会吞掉本该精确匹配的请求 - 使用
Route::any()或Route::miss()时更要小心，它们通常应放在文件末尾，作为兜底逻辑 - 多应用模式下，不同应用的路由文件（如
app/admin/route/app.php和app/api/route/app.php）是分别加载的，但若主应用也定义了相同路径，主应用路由可能因加载顺序靠前而优先生效
最隐蔽的冲突点是缓存——改完路由文件却没清 runtime/cache/route.php，旧规则还在内存里跑；或者 APP_DEBUG=true 时缓存不生效，反而让你误以为新规则“有时灵有时不灵”。动手前先 php think clear:route，比反复猜更省时间。
