RBAC路由疑问：CMS模块默认路由自动添加至全局路由的原因与解决

1. 是否需要为项目所有路由添加模块的默认路由？ #

完全不需要。模块的路由前缀只应该作用于模块内部的控制器和动作，项目里的全局路由（比如site/login、site/index这种不属于该模块的路由）根本不需要带上模块前缀。要是所有路由都被自动加上了模块前缀，那肯定是配置哪里出问题了——就像你现在碰到的情况一样。

2. 路由自动添加/cms前缀的原因及解决方法 #

为啥会出现这个问题？ #

你在CMS模块配置里写了'controllerNamespace' => 'backend\controllers'，这就相当于把模块的控制器命名空间直接指向了后端的全局控制器目录。Yii2的模块机制会默认认为这个目录下的所有控制器（比如你的SiteController）都属于CMS模块，自然就给这些控制器的所有路由都加上了cms前缀。另外你设置的'defaultRoute' => ''也没起到正确作用，反而可能让路由匹配逻辑更混乱。

怎么解决？ #

核心就是让CMS模块只管理自己的控制器，别去碰全局控制器，调整配置就行：

• 修正控制器命名空间：
  把controllerNamespace改回模块自身的控制器命名空间，比如这个CMS模块默认的yii2mod\cms\controllers（如果模块自带控制器的话）。要是你想在后端自定义CMS的控制器，应该在backend目录下新建cms子目录来放这些控制器，然后把命名空间设为backend\cms\controllers——这样Yii2就能清楚区分全局控制器和CMS模块的控制器了。
  修改后的配置片段参考：

  'cms' => [ 
      'class' => 'yii2mod\cms\Module', 
      // 方案1：用模块自带的控制器命名空间
      'controllerNamespace' => 'yii2mod\cms\controllers', 
      // 方案2：用你自定义的后端CMS控制器命名空间（需先创建backend/cms/controllers目录）
      // 'controllerNamespace' => 'backend\cms\controllers',
      'defaultRoute' => 'default', // 这里设置模块的默认路由，对应模块里的DefaultController
      'froalaEditorOptions' => [ 
          'clientOptions' => [ 
              'heightMin' => 300, 
              'theme' => 'dark', 
              'imageUploadURL' => 'upload-image', 
              'imageManagerDeleteURL' => 'delete-image', 
              'imageManagerDeleteMethod' => 'POST', 
              'imageManagerLoadURL' => 'images' 
          ], 
          'excludedPlugins' => [ 'file', 'emoticons' ] 
      ], 
      'enableMarkdown' => false 
  ]
  

• 检查全局路由规则：
  去看看urlManager里的路由配置，确保没有把全局路由错误地关联到CMS模块。如果之前写过自定义路由规则指向了CMS模块，得调整这些规则，只让CMS相关的路由使用cms前缀。
• 确认模块挂载方式：
  你是在后端配置里挂载的CMS模块对吧？确保它是作为独立模块存在的，别让它覆盖了全局的路由上下文。

总的来说，就是你把模块的控制器命名空间指向了全局控制器目录，才导致Yii2把所有全局路由都归到了CMS模块下。修正命名空间之后，这个问题就能解决啦。

内容的提问来源于stack exchange，提问作者rajwa766