多租户场景下不能通过修改composer.json的require字段切换依赖，因其解析阶段不执行PHP表达式，所有require值必须是静态字符串；可行方案仅有独立composer.json隔离vendor或运行时ClassLoader::addPsr4()动态注册。
多租户场景下不能靠修改 composer.json 的 require 字段来切换租户依赖——Composer 解析阶段不执行 PHP 表达式，任何 "vendor/{$tenant}/module" 写法都会报 Invalid package name。真正可行的路径只有两条：为每个租户生成独立 composer.json + 隔离 vendor，或运行时用 ClassLoader::addPsr4() 动态注册命名空间。
为什么不能在 composer.json 里写租户变量
Composer 的依赖图构建完全发生在 composer install 或 composer update 阶段，此时 PHP 解释器并未启动，$_ENV、getenv()、字符串拼接全不可用。所有 require 值必须是静态字符串。
- 写
"tenant-a/module": "^1.0"→ 合法，但无法适配租户 B - 写
"tenant-{$tenant}/module": "^1.0"→ 直接失败，解析器不认识$tenant - 本地手动改
composer.json切换租户 → 上线后因分支/CI 环境差异，composer.lock不一致，导致部署失败或类加载错乱 - 误以为
composer dump-autoload能扫描新模块路径 → 它只处理autoload块声明的路径，对运行时addPsr4()注册的路径完全无感
动态生成租户专属 composer.json 的实操要点
该方案适用于租户间依赖版本冲突严重（如一个要 monolog/monolog:^2.0，另一个强制 ^3.0）且需强隔离的场景。核心是把租户配置转为独立 composer.json 并指定安装目录。
- 仅允许动态字段：
name（建议设为tenant/{id}）、require（必须校验白名单，禁用dev-master等危险版本）、autoload（如 PSR-4 映射到src/tenants/{id}/） - 禁止动态字段：
autoload-dev、scripts、config中的超时或插件配置——这些属于部署环境控制，不该由租户输入决定 - 安装命令必须加
--no-scripts -d "tenants/{$tenantId}"：避免触发全局钩子（如清缓存），并确保vendor写入租户专属目录 - 生成后需手动
include_once对应租户的vendor/autoload.php，且注意ClassLoader注册顺序——主项目加载器必须先于租户加载器注册，否则命名空间可能被覆盖
运行时 addPsr4() 动态注册租户模块
该方案更轻量，适合租户模块代码不进主 vendor、只需按需加载的场景。它绕过 require，直接操作 Composer 自带的加载器实例。
- 租户模块目录结构必须符合 PSR-4，例如
modules/tenant-a/src/FeatureX/Handler.php对应命名空间App\TenantModules\A\FeatureX - 注册时机关键：Laravel 中应在服务提供者
boot()或app()->booted()回调中执行，而非每次请求都调；PHP-FPM 下每个 worker 进程都需独立执行该逻辑 - 必须检查是否已注册：
in_array('App\TenantModules\A\', array_keys($loader->getPrefixesPsr4()))，避免重复注册污染 autoload 缓存 - 路径必须是绝对路径：
base_path('modules/tenant-a/src/')，不能用相对路径或未解析的__DIR__
最容易被忽略的 ClassLoader 生命周期问题
ClassLoader::addPsr4() 注册只对当前 PHP 进程生效。Docker 容器重启、PHP-FPM worker 复用、Swoole 热重载等场景下，旧进程不会自动感知新注册的命名空间。这意味着：
- 你放好了
modules/tenant-b/src/，也调了addPsr4()，但日志里get_declared_classes()没这个命名空间 → 不是缓存没清，是那个 worker 进程压根没执行过注册逻辑 - 不能依赖
composer dump-autoload解决动态路径问题，它不处理运行时注册 - 模块发布后，必须确保所有 PHP 进程（包括队列 worker、定时任务、Artisan 命令）都重新加载了租户上下文，否则
Class not found会静默发生
