怎么打开 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 入口。
评论(0)