Composer autoload 不支持运行时动态修改，需通过 ClassLoader 实例的 addPsr4()/addClassMap() 配合 register() 生效，且路径、命名空间、权限须严格符合 PSR-4 规则，Web 环境需在每次请求入口注入，CLI/Swoole 需注意生命周期。
Composer autoload 机制不支持运行时动态修改
直接修改 composer.json 或调用 ClassLoader::addPsr4() 后不执行 dump-autoload，新路径不会生效——因为 Composer 的自动加载器在脚本启动时已固化映射表，后续注册只是往内部数组里塞数据，但 findFile() 查找逻辑默认不检查这些“后期添加”的条目。
真正起作用的，是 ClassLoader 实例本身提供的 addClassMap()、addPsr4() 和 register() 的组合用法，且必须确保该实例是当前实际被使用的那个（比如通过 require vendor/autoload.php 加载后返回的实例）。
- 多数项目中，
vendor/autoload.php返回的是一个已register()的ClassLoader实例，可直接复用 - 若手动 new 一个新实例并调用
addPsr4()，它不会自动参与自动加载流程，除非显式register() -
addPsr4()添加的前缀必须以结尾（如'App\Fix\' => '/path/to/fix/'），否则匹配失败
热修复类必须满足命名与路径严格对应
PSR-4 规则不是可选的——哪怕只差一个反斜杠或大小写错误，ClassLoader 就找不到文件。例如你注入 'AppFix' => '/var/tmp/fix/'，那么加载 AppFixUserService 时，会去查 /var/tmp/fix/UserService.php，而不是 /var/tmp/fix/UserService.class.php 或 /var/tmp/fix/userService.php。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 路径必须真实存在且 PHP 进程有读取权限（常见于 CLI 环境下 tmp 目录权限问题）
- 类名中的命名空间分隔符
会被转为目录分隔符，所以AppFixV2Loader对应/path/to/fix/V2/Loader.php - 不能用通配符或正则；每个前缀绑定一个固定物理路径，不支持子路径覆盖
如何安全替换已有类（避免 autoload 冲突）
Composer 默认把所有 PSR-4 映射合并进一张大表，先注册的规则优先级更高。如果你试图用 addPsr4() 注入同名命名空间（如 'App\Service\' => '/hotfix/'），而原项目已有 'App\Service\' => 'src/Service/'，那么加载顺序取决于注册先后：后注册的会排在前面，但仅当 findFile() 遍历到它时才生效——这容易导致部分请求走旧代码、部分走新代码，尤其在长生命周期进程（如 Swoole、Workerman）中更危险。
- 最稳妥方式：先用
$loader->unregister()卸载原始 loader，再addPsr4()新路径，最后$loader->register() - 或者改用
addClassMap()精确覆盖单个类：$loader->addClassMap(['AppServiceUserService' => '/hotfix/UserService.php']) - 注意：使用
addClassMap()后，该类不再走 PSR-4 自动发现，而是直接 require 对应文件，跳过所有命名空间路径解析
CLI 环境下热修复生效但 Web 环境失效？检查 autoloader 生命周期
Web 服务器（如 Apache + mod_php 或 PHP-FPM）每个请求都重新加载 autoloader，但不会保留上一次请求中你手动添加的路径——也就是说，你在某个请求里调用了 addPsr4()，下个请求就没了。这不是 bug，是设计如此。
- CLI 场景可用：适合跑一次性修复脚本、命令行工具补丁
- FPM 场景需配合 opcache 配置或请求入口统一注入（例如在
public/index.php开头加 loader 修改逻辑） - 若用 Swoole，需在 Worker 启动时（如
WorkerStart回调）执行路径注入，且确保所有 Worker 进程都执行了同一套注册逻辑
热修复不是魔法，它依赖对 Composer 自动加载器底层行为的理解；漏掉 register()、路径拼错、环境生命周期误判，任何一个都会让修复变成静默失败。
