composer不支持运行时切换包版本，需手动为各租户注册独立classloader并隔离命名空间，禁用优化、延迟类解析，否则将静默加载错误版本。
运行时无法真正“切换” Composer 加载的包版本
Composer 是构建时（install/update）确定依赖图并生成 vendor/autoload.php 的工具，它不提供运行时按租户动态加载不同版本同一包的能力。所谓“运行时切换”，本质是绕过 Composer 默认自动加载机制，自己控制类加载路径和版本隔离。
用 ClassLoader 手动注册租户专属 vendor 目录
核心思路：为每个租户维护独立的 vendor 目录（如 tenant-a/vendor、tenant-b/vendor），在租户上下文初始化时，用 ComposerAutoloadClassLoader 实例注册其专属 vendor/composer/autoload_psr4.php 和 autoload_classmap.php。
- 必须在租户请求进入后、业务逻辑执行前完成注册，且不能影响全局
ClassLoader - 需调用
$loader->addPsr4()和$loader->addClassMap()逐个加载映射，不能直接 require autoload 文件 - 注意命名空间冲突：若两个租户都装了
monolog/monolog，但版本不同，它们的 PSR-4 前缀（如Monolog\）会重叠，必须用租户前缀隔离（如改写为TenantAMonolog\）——这需要 patch 包或使用符号链接+定制 autoloader - 示例关键片段：
$tenantLoader = new ComposerAutoloadClassLoader(); require $tenantVendorDir . '/composer/autoload_psr4.php'; foreach ($psr4 as $prefix => $paths) { $tenantLoader->addPsr4($prefix, $paths); } $tenantLoader->register();
避免 class_exists() 或 new 触发全局 autoloader
一旦类名被 PHP 解析（比如 class_exists('SomeService')），默认 autoloader 就会触发，可能加载错版本。必须确保所有租户敏感类的引用都延迟到租户 loader 注册之后，且不经过全局链。
- 禁用
composer dump-autoload --optimize，它会把 classmap 写死进全局autoload_classmap.php，无法隔离 - 不要在配置文件、服务提供者顶层 use 类；改用字符串类名 +
Container::make($className)等方式延迟解析 - 检查错误堆栈里是否出现
vendor/composer/ClassLoader.php中的loadClass—— 如果有，说明走到了全局 loader，隔离失败 - 常见报错：
Class 'AppServicesPayment' not found，实际是因为该类被另一个租户的 loader 注册过，而当前 loader 没覆盖到
PHP 8.1+ 可考虑 #[Override] + 运行时 include，但不推荐
极少数场景下，可对单个工具类（非框架核心）用 include 加载租户专属副本，并配合 #[Override]（PHP 8.1+）尝试覆盖，但这破坏了 Composer 的依赖契约，且无法解决 trait、interface、常量等符号冲突。
- 仅适用于纯函数式、无依赖、无命名空间污染的工具包（如某个租户定制的
JsonFormatter） -
include的文件必须用declare(strict_types=1)且不含namespace，否则会与现有 autoload 冲突 - 无法处理依赖传递：如果该工具类用了
symfony/polyfill，你得手动把它也塞进租户目录并注册 - 这种方案会让
phpstan、psalm失效，IDE 跳转错乱，调试困难
