动态添加路由规则必须用addRules()，且仅在应用启动后、首次URL解析前执行；$append=false可提升优先级；规则默认不参与Url::to生成，需显式指定class；多进程下需各进程独立执行并注意缓存失效。
动态添加路由规则必须用 addRules()，且只能在应用启动后、首次 URL 解析前执行；否则规则不生效或被忽略。
addRules() 必须在应用初始化完成之后调用
Yii2 的 urlManager 在应用启动时已构建好路由解析器（RuleManager），若在 Application::init() 之前或 bootstrap 阶段过早调用 addRules()，规则会被加载进未激活的实例，后续请求仍走原始规则集。
- ✅ 正确时机：在
Controller或Module的beforeAction()中调用（确保\Yii::$app->urlManager已就绪） - ✅ 更稳妥方式：在
config/web.php的'on beforeRequest'事件里注册一次（仅需执行一遍） - ❌ 错误做法：在
index.php顶部、或BaseController构造函数中调用 —— 此时urlManager可能尚未初始化
addRules() 的 $append 参数决定匹配优先级
addRules($rules, $append) 第二个参数控制规则插入位置：true（默认）追加到末尾，false 插入到最前面。这对匹配顺序至关重要。
- ⚠️ 若新加的规则更具体（如
'user/<id:>/profile'</id:>），应设$append = false，否则可能被上面泛化规则（如'<controller>/</controller>）提前捕获 - ✅ 示例：动态开放某活动页
/promo/2026-fall，需确保它比'<controller>/</controller>先匹配：
\Yii::$app->urlManager->addRules([
'promo/<slug:[a-z\-]+>' => 'site/promo',
], false); // ← false 表示插到 rules 数组开头
动态规则不参与 URL 生成（Url::to）除非显式启用
用 addRules() 添加的规则默认只用于「请求解析」，不会被 Url::to() 识别并生成美化 URL —— 这是 Yii2 的设计限制，不是 bug。
- ✅ 解决方法：手动传入
['class' => 'yii\web\UrlRule']并确保route是字符串（不能是数组） - ✅ 示例（支持生成和解析）：
\Yii::$app->urlManager->addRules([
[
'pattern' => 'dynamic/post/<id:\d+>',
'route' => 'post/view',
'class' => 'yii\web\UrlRule',
]
], false);
此时 Url::to(['post/view', 'id' => 123]) 才会输出 /dynamic/post/123。
addRules() 后需注意缓存与多实例问题
开发环境开启 urlManager 缓存（如 'cache' => 'cache'）时，动态添加的规则不会自动失效；生产环境若使用多进程（PHP-FPM）或容器部署，每个 worker 进程需独立执行 addRules()。
- ⚠️ 常见现象：本地测试正常，上线后新规则 404 —— 很可能是缓存未清或只在一个进程里执行了
addRules() - ✅ 建议：动态规则尽量避免依赖全局缓存；如必须缓存，调用后手动触发
\Yii::$app->cache->delete('urlRules');（假设缓存组件名为cache） - ✅ 更稳做法：把真正需要动态变化的路由逻辑下沉到控制器内判断，而非强依赖
addRules()
真正难处理的不是怎么加，而是加完之后谁还记得它在哪个进程里生效、有没有被缓存锁住、URL 生成又为什么不认它——这些细节比语法本身更容易导致线上故障。
