Url::toRoute() 是生成链接的正确方法，它走 Yii2 路由规则、支持参数绑定和美化 URL；Url::to() 仅做路径拼接，不触发路由解析，易导致非规范链接。
Url::to() 和 Url::toRoute() 用哪个？
生成链接时，Url::to() 更适合静态路径或外部 URL，Url::toRoute() 才是真正走 Yii2 路由规则、支持参数绑定和美化 URL 的正确入口。硬写 Url::to(['/site/index']) 看似能用，但绕过了路由解析，一旦启用 urlManager 的 enablePrettyUrl 或自定义规则，就可能生成带 index.php? 的非规范链接，或漏掉参数重写逻辑。
常见错误现象：Url::to(['site/view', 'id' => 123]) 在开启美化 URL 后仍输出 /index.php?r=site%2Fview&id=123 —— 这说明没走路由匹配，而是做了简单拼接。
-
Url::toRoute()会调用UrlManager::createUrl()，触发完整路由匹配、参数过滤、规则应用 -
Url::to()只做路径拼接或相对路径解析，不查路由表，也不处理urlManager规则 - 传入数组时，两者都接受，但只有
Url::toRoute()保证结果受urlManager配置影响
路由数组写法：控制器/动作名必须带斜杠？
必须带。Yii2 要求路由数组第一项是形如 'site/index' 的字符串，不能写成 'site.index' 或 ['site', 'index']。这是硬性约定，不是风格问题 —— 源码里 UrlManager::parseRoute() 直接按 / 分割，且只认两级（模块/控制器/动作）的字符串结构。
使用场景：生成后台管理链接、带参数的列表页、AJAX 请求地址等，都依赖这个格式被正确识别。
- ✅ 正确：
Url::toRoute(['admin/user/view', 'id' => 456]) - ❌ 错误：
Url::toRoute(['admin.user.view', 'id' => 456])→ 报错Invalid Route: admin.user.view - ❌ 错误：
Url::toRoute([AdminUserController::class, 'actionView'], ['id' => 456])→ 不识别类名+方法名写法 - ⚠️ 模块内控制器可省略模块前缀，但仅限当前模块；跨模块必须写全，如
'blog/post/index'
生成绝对 URL 时，HTTPS 判断为什么经常出错？
Yii2 默认靠 $_SERVER['HTTPS'] === 'on' 或 $_SERVER['HTTP_X_FORWARDED_PROTO'] === 'https' 判断，但反向代理（Nginx / ALB / CDN）配置不当时，HTTP_X_FORWARDED_PROTO 可能缺失、被覆盖，或值为 http 即使实际是 HTTPS。结果就是 Url::toRoute(['site/about'], true) 返回 http:// 开头的链接，触发混合内容警告或跳转失败。
性能影响不大，但兼容性极关键 —— 尤其在 Docker、K8s、云函数等多层转发环境。
- 必须显式配置
urlManager的hostInfo，例如'hostInfo' => 'https://example.com'，才能绕过运行时判断 - 若需自动适配，得在入口脚本（
web/index.php）中提前修正$_SERVER：if (isset($_SERVER['HTTP_X_FORWARDED_PROTO']) && $_SERVER['HTTP_X_FORWARDED_PROTO'] === 'https') { $_SERVER['HTTPS'] = 'on'; } - 不要依赖
Yii::$app->request->isSecureConnection生成链接 —— 它和Url类不共享状态，且时机可能不对
URL 编码和特殊字符：中文参数或斜杠怎么处理？
Yii2 的 Url::toRoute() 默认会对参数值做 urlencode()，但不会对路由本身（如 'post/view'）编码。问题出在：如果你把含斜杠的字符串当参数传进去（比如 'category/path/to/item'），它会被整体编码成 category%2Fpath%2Fto%2Fitem，而你后端 action 的 $category 接收时还得手动 urldecode() —— 这容易遗漏，也违背 RESTful 感觉。
更隐蔽的坑是：某些 Nginx 配置会拒绝解码后的路径包含多个斜杠，直接 400。
- 参数含斜杠？优先改用 GET 参数传递，或拆成多个参数：
['post/view', 'cat1' => 'path', 'cat2' => 'to', 'item' => 'id'] - 中文路由段？不推荐。Yii2 路由规则默认不匹配 Unicode 字符，需手动加正则（如
'pattern' => 'post/<slug:>'</slug:>），且 Apache/Nginx 配置需支持 UTF-8 路径 - 想保留原始斜杠又不想编码？只能弃用
toRoute()，手拼 URL 并确保urlManager关闭enableStrictParsing，但这等于放弃路由安全校验
