codeigniter 4 不原生支持 hmvc，app/modules/auth 目录需手动配置 psr-4 映射、模块路由挂载及第三方扩展（如 wiredesignz/codeigniter-modular-extensions）才能生效，否则直接访问报 404；服务类注入适用于逻辑复用，hmvc 模块则需完整 mvc 结构与显式注册。
CodeIgniter 4 不支持原生 HMVC，所谓“模块化”必须靠你自己组织结构 + 手动注册命名空间 + 借助第三方扩展（如 wiredesignz/codeigniter-modular-extensions）来模拟，否则你写的“模块”只是文件夹，不会被自动识别或路由加载。
为什么 app/Modules/Auth 目录放进去就报 404？
CI4 默认不扫描 app/Modules/ 下的任何内容。框架压根不知道这个目录存在，更不会自动注册其中的控制器、模型或路由。
- 必须在
app/Config/Autoload.php中显式添加 PSR-4 映射：$psr4['Auth'] = APPPATH . 'Modules/Auth/'; - 模块内的控制器仍需继承
CodeIgniter\Controller，不能写成extends BaseController（除非你把BaseController也放进模块命名空间并正确 autoload） - 模块路由不会自动加载——得在模块自己的
Routes.php里定义，再通过$routes->addModule('auth')显式挂载（该方法来自第三方扩展，非 CI4 原生） - 直接访问
/auth/login会失败，因为主路由没配；必须先确保模块路由已加载，且中间件、过滤器作用域覆盖到模块路径
service('controller')->execute('Auth::login') 报 Class not found？
这不是 CI4 内置功能，而是 wiredesignz/codeigniter-modular-extensions 提供的封装。报错通常意味着三件事没做全：
- 没执行
composer require wiredesignz/codeigniter-modular-extensions，或者 Composer 安装后未触发 autoloader 更新 - 没在
app/Config/Services.php中启用该扩展的服务：需确认是否调用了$this->aliases['controller'] = \Wired\Modular\ControllerService::class; -
Auth::login中的Auth是命名空间前缀，不是目录名——它对应的是Auth\Controllers\Login类，而该类必须声明namespace Auth\Controllers;，且路径为app/Modules/Auth/Controllers/Login.php
用 Composer 引入的包能当“模块”直接嵌入页面吗？
不能。Composer 包是服务层抽象，不是视图可嵌入的 UI 单元。比如 codeigniter4/jwt-implementation 只提供 token 生成/验证能力，它没有控制器、没有视图、也没有 execute() 接口。
- 想复用带 UI 的功能（如登录表单、用户头像组件），必须自己封装成 HMVC 模块：含控制器、视图、可选模型，并暴露一个可被
execute()调用的方法 - 想复用逻辑（如发短信、导出 Excel），走服务注入更合适：
public function __construct(\App\Services\SmsSender $sms)，然后在视图中用 AJAX 或重定向跳转，而不是嵌入渲染片段 - 混用风险：把 Composer 包的类硬塞进 HMVC 控制器里调用，容易导致生命周期错乱（例如 session 在子请求中未初始化）
真正麻烦的不是怎么写模块，而是怎么让多个模块共享 session、csrf token、语言配置这些全局状态——它们在子请求中默认不继承，得手动透传或统一中间件管理。这点很容易被忽略，直到你在嵌入侧边栏用户信息时发现登录态丢失。
