多个 vendor/autoload.php 不能共存于同一 PHP 进程，因各自调用 $loader->register() 将 ClassLoader 注册进 spl_autoload_register 全局队列，并行执行导致类加载错乱、重复定义或“Class not found”；必须通过 $loader->unregister() 解除注册并手动控制加载器生命周期。
多个 vendor/autoload.php 不能共存于同一 PHP 进程
直接 require 多个项目的 vendor/autoload.php 必然冲突——不是文件报错，而是类加载行为错乱。因为每个 autoload.php 都会调用 $loader->register()，把各自的 ClassLoader 实例注册进 spl_autoload_register 全局队列。后注册的不会覆盖前一个，而是并行执行；一旦两个加载器都匹配到同一个类名（比如 AppClient），就可能从错误路径加载类，或触发重复定义 fatal error。
常见错误现象：
- 类存在但提示
Class 'X' not found（实际被另一个 autoloader 拦截却没找到） Fatal error: Cannot declare class Y, because the name is already used- 同名类在不同项目中行为不一致（如一个走 v1 逻辑，一个走 v2 逻辑）
绕过 register()：手动控制 ClassLoader 生命周期
真隔离不是靠删 vendor 或改 composer.json，而是让每个项目用自己的 ClassLoader 实例，且不把它塞进全局队列。关键动作是调用 unregister()。
实操建议：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在项目入口（如
web/v1/index.php）中：$loader = require __DIR__.'/../v1/vendor/autoload.php'; $loader->unregister(); // 必须放第一句，解除默认注册 $loader->addPsr4('App\', __DIR__.'/../v1/src/'); // 可选：补充或覆盖命名空间映射 // 后续需显式加载类，或自己封装 autoloader 闭包 - 若需自动加载，必须自己注册闭包：
spl_autoload_register(function ($class) use ($loader) { return $loader->loadClass($class) ?: false; });这个闭包只属于当前项目，不干扰其他进程 - 绝对不要在 CLI 脚本里
include_once多个 autoload ——ClassLoader内部的static属性（如$prefixLengthsPsr4）是跨文件共享的，会导致映射污染
PHP 版本切换后必须重建 vendor/ 和 composer.lock
vendor/autoload.php 本身不绑定 PHP 版本，但它生成的 vendor/composer/autoload_static.php 会根据当前 PHP 版本的反射行为、语法支持（如 match 表达式、联合类型）做静态优化。PHP 8.3 下生成的 autoload 文件，在 7.4 下运行会直接抛 ParseError。
所以：
- 每次切换 PHP 版本（如从
php@8.1切到php@8.3），必须rm -rf vendor composer.lock - 然后用目标版本的
php执行composer install，而不是复用旧vendor - CI/CD 流水线中，要确保
php -v与composer install使用的是同一二进制（避免php@8.1下跑composer install却用php@8.3运行）
为什么 unset($loader) 或 include_once 无效
很多人以为 unset($loader) 就能“卸载”加载器，但这是错觉。PHP 不提供 spl_autoload_unregister 的反向接口，register() 注册的是匿名函数或对象方法引用，unset 只销毁变量，不影响已注册的回调。同样，include_once 对 autoload.php 也没用——它返回的是同一个 ClassLoader 实例，而该实例的静态注册状态已在第一次 register() 时写入全局。
真正容易被忽略的点：
- Web 服务器（如 PHP-FPM）worker 进程可能复用，导致上一个请求注册的 autoloader 影响下一个请求
- CLI 脚本如果 fork 或 require 其他项目入口，也会继承已注册的 autoloader
- ThinkPHP、Laravel 等框架的测试套件常隐式 require 自己的 autoload，和主项目冲突却不报错，只在特定类加载时暴露
