Yii2的UrlRule路由匹配严格从上到下顺序执行，无自动优先级；复杂规则失效主因是泛化规则前置截断请求，须将约束最强的规则置顶，并确保enablePrettyUrl和showScriptName正确配置。
Yii2 的 UrlRule 路由匹配是严格按顺序从上到下执行的，**没有自动优先级算法，顺序即优先级**。所谓“复杂正则路由匹配优先级调整”，本质就是手动控制规则在 rules 数组中的位置，并确保语法精准，避免泛化规则提前截断请求。
为什么你的复杂规则没生效？
最常见原因是：更宽泛的规则（如通用控制器路由）写在了前面，把本该由精细正则匹配的请求提前“吃掉”了。比如：
-
'<controller:\w+>/<id:\d+>' => '<controller>/'放在前面 →/post/123被它匹配，/post/2024/10/title-slug就永远到不了后面的复杂规则 - 规则 key 写成
'post/<year:\d{4}>/<month:\d{2}>/<slug:[a-z0-9\-]+>'，但 value 是数组（如['route' => 'post/view']）→ 该规则只用于解析请求，Url::toRoute()生成链接时直接跳过 - 没启用
enablePrettyUrl => true或showScriptName => false→ 所有自定义规则形同虚设
如何正确组织复杂正则规则的顺序
把约束最强、路径最具体的规则放在数组顶部，逐级放宽。例如博客系统中：
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
'post/<year:\d{4}>/<month:\d{2}>/<slug:[a-z0-9\-]+>' => 'post/view''post/archive/<year:\d{4}>' => 'post/archive''post/tag/<name:[\w\-\+]+>' => 'post/tag'-
'post/<id:\d+>' => 'post/view'（ID 形式兜底） -
'post/' => 'post/index'（列表页）
这样 /post/2024/10/my-first-post 就不会被 'post/<id:\d+>' 错误匹配为 ID=2024。
正则写法与参数提取要点
路径中用 <param:pattern> 提取参数，pattern 是纯正则片段（不带 /），框架自动包裹成完整正则：
-
<id:\d+>→ 实际等价于(\d+) -
<slug:[a-z0-9\-]+>→ 注意连字符-必须放末尾，否则会被识别为范围符 -
<version:v\d+\.\d+>可匹配v2.1、v10.0 - 不写 pattern（如
<id>）→ 默认等价于([^/]+)，接受任意非斜杠字符（含字母、符号），安全性低，慎用
调试匹配失败的三步检查法
当访问路径 404 或 Url::toRoute() 不生成美化 URL 时，依次确认：
- 入口配置是否启用美化：
'enablePrettyUrl' => true和'showScriptName' => false是否同时存在且为 true/false - 规则是否挂载到
urlManager.rules（不是仅写在 components 其他位置） - 用
yii debug或临时加日志，在UrlManager::parseRequest()中打印当前匹配过程，或用var_dump($rule->createUrl(...))测试单条规则生成能力
