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。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

• 必须在租户请求进入后、业务逻辑执行前完成注册，且不能影响全局 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 跳转错乱，调试困难

租户级包版本隔离不是 Composer 的设计目标，真正的复杂点在于：类名全局唯一、autoloader 全局共享、PSR-4 映射不可撤销。任何“运行时切换”都意味着你要亲手接管从类名到文件路径的整个映射过程，稍有遗漏就会静默加载错版本。