composer 本身不支持按租户隔离 autoloader，vendor/autoload.php 全局唯一；破解方法是使用 --no-autoloader 分别安装各租户依赖，并在入口处按需显式加载对应 autoload.php，确保类加载前完成且避免框架核心重复加载。
多租户下 Composer 的 autoload 冲突怎么破？
直接说结论：Composer 本身不支持「按租户隔离 autoloader」，composer install 生成的 vendor/autoload.php 是全局唯一的。强行让不同租户加载不同版本的同一包（比如 monolog/monolog v2 和 v3），会导致类名冲突、Class not found 或静默覆盖——这不是配置问题，是设计限制。
为什么 vendor 目录不能按租户拆分？
Composer 的依赖解析和 autoloading 都基于项目根目录下的 composer.json 和生成的 vendor/composer/autoload_*.php 文件。即使你手动把 vendor 复制三份到 tenant-a/vendor、tenant-b/vendor，只要入口脚本 require 的仍是同一份 autoload.php，PHP 就只会注册一次自动加载器，后续 class_exists() 或 new 实例时，永远走的是最后加载的那个版本。
- 多个
vendor目录 ≠ 多个 autoloader 实例 -
require_once 'vendor/autoload.php'在 PHP 生命周期里只生效一次 - PSR-4 映射写死在
vendor/composer/autoload_static.php里，无法运行时切换
可行路径：用 Composer 的 --no-autoloader + 手动加载租户专属 vendor
核心思路是绕过 Composer 默认的单点 autoloader，为每个租户构造独立的加载上下文。前提是租户代码入口可区分（如通过子域名、路径前缀或中间件路由）。
- 执行
composer install --no-autoloader --no-scripts，避免生成全局 autoload 文件 - 为每个租户维护独立的
composer.json（例如tenants/a/composer.json），运行composer install --no-autoloader得到专属vendor - 在租户入口文件中，显式 require 对应的
vendor/autoload.php，并确保该 require 发生在任何类加载之前 - 注意：所有租户共享的框架代码（如 Laravel 核心）必须提前加载且不依赖租户级包，否则会因类重复定义报
Cannot redeclare class
示例入口逻辑：
if ($_SERVER['HTTP_HOST'] === 'a.example.com') {
require __DIR__.'/tenants/a/vendor/autoload.php';
} elseif ($_SERVER['HTTP_HOST'] === 'b.example.com') {
require __DIR__.'/tenants/b/vendor/autoload.php';
}
更稳的做法：用 Symfony Runtime + 自定义 Bootstrapper
如果你用的是 Symfony 或兼容 PSR-15 的框架，可以用 Symfony\Component\Runtime\Runtime 控制启动时机，在 runtime 初始化前动态设置 vendor 路径。关键点在于：必须在 spl_autoload_register() 被调用前完成租户判定和 autoload 加载。
- 不要在 middleware 或 controller 里 require autoload —— 此时框架核心类可能已加载，再加载租户 vendor 会触发类重定义错误
- 租户标识（如 DB 连接、配置）若需从数据库读取，得先用轻量级 PDO 或环境变量兜底，避免循环依赖
- PHP-FPM 下每个请求是独立进程，但 opcache 会缓存已加载的类——务必禁用
opcache.enable_cli=0并确认opcache.validate_timestamps=1，否则租户切换后旧类仍驻留内存
物理隔离真正难的不是复制 vendor，而是保证 autoloader 注册顺序、类加载边界、以及 opcache 和 APCu 的缓存键不跨租户污染。
