autoload冲突本质是命名空间注册重复，即同一命名空间被多个autoloader重复注册；临时兼容需注释手动加载、显式声明第三方命名空间并dump-autoload，必要时用"autoload.files"统一管理。
autoload 冲突本质是命名空间注册重复
不是文件没找到，而是同一个命名空间被多个 autoloader 注册了两次——比如你一边在 composer.json 里写了 "psr-4": {"App\": "app/"}，另一边又在代码里手动 require_once 'app/Helper.php'，或第三方包自带 ClassLoader::add()。Composer 的自动加载器一旦和手动加载逻辑撞上，class_exists() 可能返回 true，但 new 实例时却报 Class not found，因为实际加载的是旧路径下的旧类。
临时兼容的三步操作法
不改结构、不删代码、不升级包，只做最小干预：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 注释掉所有手动
include、require、require_once加载类文件的语句（尤其是bootstrap.php或入口文件里） - 检查是否有第三方包自带 autoload 逻辑（常见于老 SDK 或私有组件），在
vendor/下搜ClassLoader::add、spl_autoload_register、__autoload；找到后，在composer.json的"autoload"中显式声明其命名空间，并运行composer dump-autoload -o - 若必须保留某段手动加载（如兼容遗留模块），把它挪到
composer.json的"autoload": {"files": ["path/to/legacy.php"]}，这样 Composer 会统一在启动时 require，避免时机错乱
为什么 dump-autoload -o 不能解决所有问题
优化类映射（-o）只是把 PSR-4 映射预生成进 autoload_classmap.php，但它不清理已注册的其他 autoloader。如果冲突来自已注册的 spl_autoload_register 回调（比如 ThinkPHP 自带的 Loader、CodeIgniter 的 MY_Loader），光 dump 没用。此时要确认框架是否启用了 Composer 自动加载开关——例如 CI3 的 $config['composer_autoload'] = TRUE;，TP6 则默认强制走 Composer，而 TP5.1 需手动开启。
重构中容易忽略的陷阱
最隐蔽的冲突点是：你改了命名空间，但没同步改 use 语句或 composer.json 的 autoload 配置。比如把 app/library/Payment 移到 src/Payment，却忘了把 "psr-4": {"App\": "app/"} 改成 {"App\": "src/"}，结果旧类还在被加载，新类根本进不了映射表。这类问题不会报错，只会让新功能静默失效。
