defaultRoute未生效主因是请求未进入Yii框架或被urlManager其他规则提前匹配：先验证index.php是否执行（如加日志），再检查enablePrettyUrl与Web服务器重写规则（Nginx需try_files、Apache需mod_rewrite+AllowOverride All）是否配套，最后确认defaultRoute配置位置正确且未被空规则或模块隔离覆盖。
defaultRoute 本身没失效，是它根本没被 Yii 路由系统看到 —— 大概率因为请求压根没进框架，或进来了但被 urlManager 的其他规则提前匹配并终止了。
检查入口脚本是否真在执行 index.php
defaultRoute 只在 Yii 应用启动后才起作用。如果 Web 服务器直接返回 404 或空白页，说明连 index.php 都没跑起来。
- 直接访问带
index.php的完整 URL，比如http://yoursite.com/index.php/site/about，能打开就说明框架运行正常；打不开就得先查 Nginx/Apache 配置、vendor/autoload.php路径、PHP 扩展是否齐全 - 在
web/index.php开头加一行：file_put_contents('/tmp/yii-start.log', 'start at ' . date('c') . "\n", FILE_APPEND);，看日志有没有写入，确认脚本是否被执行 - Windows 下特别注意
index.php文件权限（IUSR 或 IIS_IUSRS 是否有读取权）
确认 urlManager 没用 enablePrettyUrl 却没配重写规则
当 'enablePrettyUrl' => true 时，Yii 依赖 Web 服务器把请求转发给 index.php 并附带原始路径。没配好，defaultRoute 就没机会触发。
- Nginx 中必须有
try_files $uri $uri/ /index.php?$args;，缺$args会导致$_SERVER['REQUEST_URI']为空，Yii 解析不出路由 - Apache 要确保
.htaccess生效，且mod_rewrite已启用；检查AllowOverride All是否在对应<directory></directory>块里 - 如果只是临时调试，可先关掉 pretty URL：
'enablePrettyUrl' => false，此时 defaultRoute 在index.php后生效，比如访问/index.php自动跳转到/index.php/site/index
排查路由规则覆盖或配置位置错误
defaultRoute 是兜底行为，一旦某条 urlManager->rules 匹配成功，就不会再走 defaultRoute。
- 检查是否写了类似
'' => 'site/index'这样的空规则 —— 它会吃掉所有根路径请求，让 defaultRoute 彻底无用武之地 - 确认
defaultRoute是设在config/web.php的'components' => ['urlManager' => [...]]里，不是写在控制器、行为或模块配置中 - 高级模板前后端共用一份 config？
frontend/config/main.php和backend/config/main.php必须各自独立设置defaultRoute，不能只改一个 - 如果用了模块（如
admin），defaultRoute 默认只对应用级路由生效；想让它在模块内也起作用，得在模块配置里单独设'defaultRoute' => 'dashboard/index'
验证是否被 errorAction 或 beforeAction 拦截
某些中间环节会在路由解析前就中断流程，导致 defaultRoute 根本不参与调度。
- 检查
SiteController::beforeAction()是否无条件return false或抛出异常（比如权限判断失败直接 throw new ForbiddenHttpException） - 如果
errorHandler->errorAction配了但没生效，YII_DEBUG=true 时会强制显示调试页，掩盖 defaultRoute 行为；生产环境务必确认defined('YII_DEBUG') or define('YII_DEBUG', false); - URL 中包含非法字符（如未编码的空格、控制字符）可能触发
yii\web\BadRequestHttpException，直接跳过路由分发，此时 defaultRoute 不会介入
最易被忽略的是：defaultRoute 只影响“未匹配任何规则 + 未指定 action”的请求。它不是万能跳转，而是一道最后防线。真正要查的，往往不是它为什么不生效，而是为什么请求连这道防线都触碰不到 —— 先确认 $_SERVER['PATH_INFO'] 或 $_SERVER['REQUEST_URI'] 有没有被 Web 服务器正确传进来，比调代码更关键。
