Yii无内置路由调试模式，需通过启用UrlManager的showScriptName、配置日志通道记录yii\web\UrlManager类别、在action中调用Yii::info验证，并用parseRequest()手动模拟匹配来实现。
怎么打开 Yii 路由调试模式
Yii 不提供开箱即用的“路由匹配日志”，但可以通过开启 yii\web\UrlManager 的 showScriptName + 日志级别 + 自定义日志通道，把每次请求的匹配过程打出来。关键不是看配置是否写对，而是看实际请求进来时，Yii 拿着 URL 去哪条规则里试、试了几次、为什么失败。
实操建议：
- 在
config/web.php中给urlManager加上'enablePrettyUrl' => true和'showScriptName' => false（否则重写未生效时所有规则都不触发） - 确保
log组件已启用，并添加一个专门记录路由的日志目标，比如：'targets' => [ [ 'class' => 'yii\log\FileTarget', 'levels' => ['info'], 'categories' => ['yii\web\UrlManager'], 'logFile' => '@runtime/logs/route.log', ], ] - 在任意控制器 action 开头加一句
\Yii::info("Route matched: " . \Yii::$app->requestedRoute, 'yii\web\UrlManager');，能快速验证日志是否写入
为什么 createUrl() 生成的 URL 总和预期不符
这不是路由没配好，而是 createUrl() 默认走“逆向匹配”：它不查规则列表顺序，而是从第一条开始尝试填参数，一旦某条规则的 pattern 里所有占位符都能被当前参数满足，就立刻选用——哪怕后面有更精确的规则。
常见错误现象：
- 本想生成
/post/123，结果出来/p/123（因为'p/<id:>' => 'post/view'</id:>在配置里排在'post/<id:>' => 'post/view'</id:>前面） - 传了多余参数，比如
['post/view', 'id' => 123, 'source' => 'email']，但某条规则没声明source，它就被默默丢弃，不报错也不警告
解决办法：
- 把更具体的规则写在前面，通用规则（如
'<controller>/<action>'</action></controller>）永远放最后 - 用
createUrl()时显式指定'ruleName'参数，强制走某条规则：\Yii::$app->urlManager->createUrl(['post/view', 'id' => 123], 'post-view-rule')（前提是该规则定义了'name'） - 检查规则中
suffix是否一致：如果全局设了'suffix' => '.html'，但某条规则单独写了'suffix' => ''，createUrl()就可能跳过它
如何手动触发并查看某 URL 被哪条规则匹配
别靠猜，直接用 UrlManager::parseRequest() 模拟一次解析。它返回 [route, params] 或 false，是最接近真实请求处理链的调试入口。
实操建议：
- 在
index.php入口或yii shell里执行：$request = new \yii\web\Request(); $request->setUrl('/user/profile/42'); var_dump(\Yii::$app->urlManager->parseRequest($request)); - 注意：必须保证
$request->url是去除域名和脚本名后的路径（如/user/profile/42，不是https://example.com/index.php/user/profile/42） - 如果返回
false，说明没一条规则能吃下这个 URL；此时逐条注释规则再试，就能定位是哪条正则写错了（比如<id:></id:>却传了字母）
Apache/Nginx 重写没生效导致路由全 404
URL 规则本身再正确，Web 服务器没把请求转给 index.php，UrlManager 根本没机会运行。这是最常被忽略的前置条件。
检查点：
- Apache：确认
.htaccess文件存在且被允许（AllowOverride All），内容是否含RewriteRule ^(.*)$ /index.php?r=$1 [L]类似逻辑 - Nginx：确认 server 块中有类似
try_files $uri $uri/ /index.php?$args;，且location ~ \.php$块里包含fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; - 开发环境用
php -S启动时，默认不支持重写，必须手动加路由文件：php -S localhost:8000 router.php，其中router.php要返回file_exists(__DIR__ . '/' . $_SERVER['REQUEST_URI']) ? false : __DIR__ . '/index.php';
复杂点在于：有些主机商禁用了 mod_rewrite 或限制了 try_files 使用方式，这时候连 UrlManager 的日志都看不到——得先让请求真正抵达 Yii 入口。
