yii2模块必须在应用配置的'modules'数组中显式注册才能使用yii::$app->getmodule()，未注册则返回null；可通过'enabled'控制激活状态，但注册本身不可动态进行。
模块没注册进 Module 类就别想用 Yii::$app->getModule()
Yii2 的模块不是“放那儿就能自动加载”的，它必须先在应用配置里显式声明。哪怕你只是想按需加载（比如只在后台请求时初始化），也得先把模块类名、ID 和基础配置塞进 'modules' 数组里。否则调用 Yii::$app->getModule('admin') 会直接返回 null，连 autoloader 都不会触发——因为 Yii 根本不知道这个模块存在。
实操建议：
-
'modules'配置项必须在web.php或console.php的return [ ... ]中顶层定义，不能藏在子数组或运行时才赋值 - 模块 ID（如
'admin'）要和代码中调用的 ID 完全一致，大小写敏感 - 如果模块类不在默认命名空间（如
app\modules\admin\Module），必须用完整类名，并确保已通过 Composer 自动加载或手动require
想“按需”加载？靠的是模块的 bootstrap 和 enabled 控制
Yii2 没有“动态注册模块”的 API，但可以通过条件逻辑控制模块是否真正启动。核心是两个机制：bootstrap 数组决定哪些模块在应用启动时自动运行（比如注册组件、监听事件），而 'enabled' => false 能让模块注册但不激活——它不会执行 init()，也不会响应路由，但 getModule() 仍能拿到实例。
常见错误现象：写了条件判断却放在 modules 外面，结果配置根本没生效；或者误以为设了 'class' => 'xxx' 就等于模块已“加载”，其实只是类名注册，没触发任何生命周期。
实操建议：
- 在配置中用 PHP 表达式判断环境或请求特征，例如：
'admin' => ['class' => 'app\modules\admin\Module', 'enabled' => YII_ENV_ADMIN] - 把需要前置初始化的模块（如权限检查、菜单注入）放进
'bootstrap' => ['admin']，但注意这会让模块在每次请求都运行init() - 若只想在特定控制器/动作中用模块功能，可保持
'enabled' => true，但在模块init()里加运行时校验（如检查Yii::$app->requestedRoute）
Module::getInstance() 不是万能钥匙，它只对已注册模块有效
有人试过在控制器里写 Module::getInstance('admin') 想绕过配置注册，结果返回 null。这是错的——Module::getInstance() 是静态方法，但它依赖的是应用已知的模块注册表，不是靠反射自动发现类。没进 'modules' 配置，它连类文件都不会尝试加载。
使用场景限制很明确：只有模块已在配置中声明，且满足 enabled === true（或未设置 enabled），这个方法才可能返回实例；否则一律失败。
实操建议：
- 不要在配置外尝试“手动 new Module()”再塞进应用，Yii 的模块管理是单例+注册表驱动，绕不过去
- 调试时直接 dump
Yii::$app->modules，看目标模块 ID 是否在键名中，比猜错误原因快得多 - 如果模块类路径报错（如
Class 'app\modules\admin\Module' not found），优先检查composer autoload配置或aliases是否正确映射
模块路由匹配失败？大概率是 urlManager 没配好前缀
模块注册成功、getModule() 也能拿到实例，但访问 /admin/site/index 404？问题往往出在 URL 解析层。Yii2 默认不会为模块自动加路由前缀，除非你在 urlManager 里显式开启 'enablePrettyUrl' => true 并配置规则，或者更常见的是：忘了在模块配置里加 'as' => 'admin' 这种别名绑定。
性能影响很小，但兼容性陷阱明显：开发环境开了 enablePrettyUrl，生产环境关了，模块路由就全挂掉；或者用了 Nginx 但没配 try_files，导致 PATH_INFO 丢失，模块名根本传不到 Yii。
实操建议：
- 确认
urlManager配置中'rules'包含类似'admin/<action:>' => 'admin/default/<action>'</action></action:>的显式映射 - 模块内控制器动作找不到时，先查
Yii::$app->controller->module是否为当前模块实例，再查Yii::$app->requestedRoute解析出的实际路由 - 避免在模块配置里写死
'controllerNamespace' => 'app\modules\admin\controllers'却忘了该命名空间下真有控制器文件
