不能靠改Composer autoload机制实现多租户代码隔离，因其不支持运行时按租户切换类加载路径；可行方案仅有两种：为每个租户生成独立composer.json并隔离vendor，或运行时用ClassLoader::addPsr4()动态注册命名空间。
不能靠改 Composer 的 autoload 机制实现多租户代码隔离——它天生不支持运行时按租户切换类加载路径。真正能落地的只有两条路：为每个租户生成独立 composer.json + 隔离 vendor，或运行时用 ClassLoader::addPsr4() 动态注册命名空间。
为什么 autoloader-suffix 不解决类隔离问题
autoloader-suffix 只改生成的自动加载器类名（比如从 ComposerAutoloaderInitabcd1234 变成 ComposerAutoloaderInitTenantA），不碰 PSR-4 映射、不改 vendor/composer/autoload_psr4.php、也不影响实际类文件查找逻辑。如果你遇到 Class not found 或两个租户同名类互相覆盖，加 suffix 没用。
- 它唯一能避开的是
spl_autoload_register注册同名初始化类导致的Fatal error: Cannot declare class - 必须配合手动
require_once 'tenants/a/vendor/autoload.php'才生效，且要求你主动管理多个 autoload.php 的加载顺序 - 一旦
vendor/已生成，改composer.json里的autoloader-suffix再跑composer dump-autoload完全无效——必须删掉vendor/重装 - 若租户目录用了
--no-autoloader，则 suffix 设置压根不生成任何 autoload 文件，彻底失效
动态 addPsr4() 的实操边界与陷阱
这是轻量级方案，适合租户模块代码不进主 vendor、只需按需加载的场景。它绕过 require，直接操作 Composer 自带的 ClassLoader 实例。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 注册前务必检查是否已存在：
$loader->getPrefixesPsr4()['AppTenantModulesA\'] ?? null，避免重复映射污染 autoload 缓存 - 命名空间末尾必须带双反斜杠：
'AppTenantModulesA\' => 'modules/tenant-a/src/'，少一个反斜杠会导致 PSR-4 匹配失败 -
composer dump-autoload对动态路径完全无感——它只扫描composer.json中autoload块声明的路径 - 每次请求都调用
addPsr4()有性能开销；Laravel 中建议在app()->booted()里单次注册，CLI 脚本中可用静态变量控制 - ClassLoader 实例生命周期绑定 PHP 进程，FPM worker 不重启就看不到新注册的路径——不是缓存问题，是实例没重建
独立 composer.json 方案的关键校验点
该方案适用于租户间依赖版本冲突严重（如一个要 monolog/monolog:^2.0，另一个强制 ^3.0）且需强隔离的场景。核心是把租户配置转为独立 composer.json 并指定安装目录。
- 仅允许动态字段：
name（建议设为tenant/{id}）、require（必须白名单校验包名，禁用dev-master等危险版本）、autoload（如"Tenant\{$tenantId}\" => "src/tenants/{$tenantId}/"） - 禁止动态字段：
autoload-dev、scripts、config中的超时或插件配置——这些属于部署环境控制，不该由租户输入决定 - 安装命令必须加
--no-scripts -d "tenants/{$tenantId}"：避免触发全局钩子（如清缓存），并确保vendor写入租户专属目录 - 运行时不能
require vendor/autoload.php，而是显式include_once 'tenants/{$tenantId}/vendor/autoload.php'，且注意 ClassLoader 注册顺序——主项目加载器必须先于租户加载器注册，否则命名空间可能被覆盖 - 生成后需校验
tenants/{$tenantId}/vendor/composer/autoload_static.php中的$prefixLengthsPsr4是否正确映射，这是 PSR-4 加载性能关键
最常被忽略的一点：ClassLoader 注册顺序不是“谁先 require 谁优先”，而是“谁后注册谁覆盖”——如果租户加载器在主项目之后注册，且命名空间前缀相同（如都注册了 App\），租户的映射会把主项目的顶掉。这不是 bug，是设计使然。
