Yii模块配置需在模块类init()中用Yii::configure($this, require DIR . '/config.php')显式加载；config.php须返回含params、components等顶层键的数组；模块内components仅对模块路由生效，params需手动读取或合并。
模块配置文件怎么放才被 Yii 正确加载
Yii 不会自动扫描模块目录下的 config.php 或 main.php，必须显式在模块类的 init() 里手动加载。否则配置看似存在，实际完全不生效。
- 模块类（如
app\modules\user\UserModule）的init()方法中，用Yii::configure($this, require __DIR__ . '/config.php'); -
config.php必须返回一个数组，结构与应用配置顶层一致（支持components、params、modules等键） - 路径必须用
__DIR__，不能用相对路径或别名（如@app），否则在控制台命令等上下文中容易失效
模块配置里的 components 覆盖规则很隐蔽
模块内定义的 components 不会全局替换应用级同名组件，只在模块内及其子控制器/视图中生效——但前提是模块内请求走的是模块路由（如 /user/profile），且组件访问方式是 $this->module->getComponent('xxx') 或通过 $this->context->module->getComponent()。
- 直接调
Yii::$app->get('xxx')拿到的仍是应用级组件，不是模块配置的 - 模块内重定义
urlManager、request等核心组件基本无效，它们由应用统一管理，模块只能覆盖行为（Behavior）或扩展属性 - 若需模块专属 DB 连接，建议用新组件 ID（如
userDb），避免和db冲突导致意外交互
params 在模块配置里写错位置就白写了
params 必须作为模块配置数组的顶层键，不能嵌套在 components 或其他子项里；而且模块的 params 不会自动合并进 Yii::$app->params，得自己读取。
- 正确写法：
return ['params' => ['user.default_role' => 'member'], 'components' => [...]]; - 读取方式：
$this->module->params['user.default_role']，不是Yii::$app->params - 如果想让模块 params 合并进应用级 params，得在
init()里手动做Yii::$app->params = array_merge(Yii::$app->params, $this->params);，但要注意键名冲突风险
调试时看不到模块配置生效？先查这三个地方
常见“配置写了但没反应”，90% 出在加载时机或作用域误判上。
- 用
var_dump($this->module->params)或var_dump($this->module->getComponents())直接在模块内控制器 action 中验证，比看日志更直接 - 检查模块是否真被注册：在应用配置的
modules数组里，对应模块 key 的值必须是完整类名或含class键的数组，不能只是字符串别名 - CLI 场景下模块配置不生效？因为控制台应用（console app）和 Web 应用配置分离，模块配置文件得单独给 console 加载，或改用条件判断
if (YII_ENV_WEB) { ... }
模块配置本质是“局部作用域”的覆盖逻辑，不是插件式热加载。路径、时机、作用域边界这三点卡住，配置再全也没用。
