autoload中路径引用（如../src）会引发冲突，因Composer合并所有包的psr-4/classmap配置，相对路径导致源码目录被注入其他包上下文，造成类加载错乱、重复声明或命令失效，需用composer dump-autoload -vvv定位并清理污染路径。
依赖冲突里出现路径引用（比如 ../src、../../vendor）基本是 autoload 配置惹的祸，不是版本号问题，删 vendor 或改 composer.lock 没用。
为什么 autoload 里的路径会引发冲突？
Composer 不只看 require，还会把所有包的 autoload（尤其是 psr-4 和 classmap）合并进统一加载规则。一旦某插件或 require-dev 包在 composer.json 里写了含 ../ 的路径，它就可能把你的源码目录“注入”到其他包的加载上下文中——反过来也一样。
常见现象：
-
phpunit/phpunit的autoload声明了"App": "../src/"，导致你项目里的AppHttpController被它提前加载 - 你自己的
autoload-dev里误加了"MyPlugin\": "vendor/myorg/plugin/src/"，等于让主项目“依赖自己” - 私有包用了
classmap扫描了整个../目录，把测试工具的类也塞进了自动加载器
这类问题不会报 “version conflict”，而是表现为：Class not found、Cannot redeclare class、composer install 卡在 Resolving dependencies，或者插件命令完全不响应。
composer dump-autoload -vvv 是唯一能验证 autoload 是否生效的命令
它会逐行输出 Composer 实际注册的命名空间和路径映射。重点看两处：
- 有没有你预期的插件命名空间（如
VendorPlugin）被列出来？没出现 = 插件 autoload 没被读取（可能是type不是composer-plugin，或被repositories配置绕过） - 有没有不该出现的路径，比如
../src/或../../vendor/出现在输出里？有 = 某个包正在悄悄污染加载范围
执行后立刻 grep：
composer dump-autoload -vvv | grep -E "(../|../../|src/)"
如果输出非空，说明路径污染已发生——顺着路径反查对应包的 composer.json，删掉或收紧它的 autoload 配置。
require-dev 是路径冲突的高发区，必须单独排查
很多循环和冲突根本不在 require，而藏在 require-dev 里。它们虽不参与生产部署，但 Composer 解析依赖时全程参与计算，且自带宽松 autoload。
- 临时注释掉全部
require-dev条目，再跑composer update --dry-run；如果不卡了，问题就在这里 - 逐个恢复，每加一个就运行
composer show package-name | grep autoload，特别盯住含../、../../、src/的路径 - 对
phpunit/phpunit、infection/infection、phpstan/phpstan这类工具包，优先查它们的官方composer.json—— 很多老版本默认把../src加进 autoload，新版已移除
别信文档或印象，composer show package-name 输出的 autoload 字段才是真实生效配置。
破环只能靠重构，没有绕过开关
Composer 不提供 --ignore-cycle 或 --force-autoload 这类选项。一旦路径级循环形成（比如 A 包 autoload 引入 B 包代码，B 包又 require A），唯一解法是拆分或抽离：
- 把双方共用的接口、DTO、异常类抽成独立包（如
myorg/contracts），让 A 和 B 都只require它，不再互相 autoload - 把单体包按职责切开（如
myorg/core-api和myorg/core-domain），让 API 层依赖 domain，但 domain 层不反向加载任何 API 类 - 删除所有
autoload中的相对路径，改用明确的 PSR-4 映射（如"MyOrg\Core\": "src/Core/"），禁止使用""或"App\"这类宽泛前缀
最容易被忽略的一点：即使你没写任何 ../，只要某个依赖包写了，它就会生效——Composer 的 autoload 合并是全局的，不区分“谁写的”。所以冲突根源往往在第三方包，而非你自己的配置。
