模块化依赖管理必须采用“静态主干+运行时加载”两层机制，因composer.json不执行PHP，无法解析变量或租户占位符，否则报Invalid package name错误；租户模块须通过ClassLoader::addPsr4()在运行时动态注册PSR-4命名空间映射，并确保在app()->booted()中执行且防重复注册。
模块化依赖管理不能靠 composer.json 的 require 字段动态写租户包名——那会直接报 Invalid package name 错误，必须拆成「静态主干 + 运行时加载」两层机制。
为什么 composer.json 里不能写变量或租户占位符？
Composer 解析 composer.json 是纯文本阶段，不执行 PHP。像 "vendor/{$tenant}/module-a": "^1.0" 这种写法，连语法校验都过不去，更别说安装了。常见错误现象是：本地改完手动提交，上线后 CI/CD 流水线跑 composer install 直接失败，报错信息里明确提示包名非法。
所有共用基础能力（如 laravel/framework、spatie/multitenancy）才该进根 composer.json；租户私有模块必须脱离 require 管理。
如何让租户模块类被自动加载到？
核心是绕过 require，用 Composer 自带的 ClassLoader::addPsr4() 在运行时注册命名空间映射。
- 确保模块目录结构符合 PSR-4，例如
modules/tenant-a/src/FeatureX/Handler.php对应命名空间AppTenantModulesAFeatureX - 在租户上下文初始化处（如 Laravel 中间件或服务提供者里）调用：
$loader->addPsr4('AppTenantModulesA\', base_path('modules/tenant-a/src/')) - 务必先检查是否已注册：
in_array('AppTenantModulesA\', $loader->getPrefixesPsr4())，避免重复注册污染 autoload 缓存 - 注册时机建议用
app()->booted()控制，保证只执行一次，而不是每次请求都调
为什么 dump-autoload 不扫描我新加的模块路径？
composer dump-autoload 只处理 composer.json 里 autoload 和 autoload-dev 字段声明的路径，对运行时用 addPsr4() 注册的路径完全无感知。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
这意味着：你放好了模块文件、也调了 addPsr4()，但请求仍抛 Class not found，大概率是因为 PHP-FPM worker 进程没重启，旧的 ClassLoader 实例还活着，根本不知道新路径存在。
这不是缓存没清，是 ClassLoader 生命周期问题——PHP 进程不重载，新注册就无效。
要不要用 nwidart/laravel-modules 这类包？
它适合「统一管理多个功能模块」的场景，比如后台 CMS 拆出 user-module、order-module，每个模块可独立启用/禁用、含自己的 migrations 和 routes。但它默认仍把模块当「项目内子目录」处理，所有模块代码都进主 vendor 加载链，不适合多租户隔离。
如果你的模块要按租户分发、版本独立、甚至走私有 Packagist 发布，就别把它塞进 Modules/ 目录下用 merge-plugin 合并 autoload——那只是把多个 composer.json 合成一个逻辑，本质还是静态依赖，无法解决租户级动态加载。
真正关键的分界点在于：模块是否需要跨环境、跨租户做版本控制和发布。需要，就走私有仓库 + 运行时 addPsr4()；不需要，用 laravel-modules 更省事。
