Composer遇到循环依赖直接报错退出，必须从结构上打破闭环；确认方式为查看报错信息是否出现互相依赖描述、执行composer update --dry-run -v观察回溯路径、或运行composer depends --tree定位vendor/a ← vendor/b ← vendor/a式闭环。

Composer 遇到循环依赖直接报错退出，不尝试绕过、不降级、不忽略——这不是版本选得不对，而是依赖图在逻辑上不可解。你看到 Root package cannot be installed 或 Package a depends on b, which depends on a，基本就是闭环实锤。

怎么确认是循环依赖，不是普通冲突

错误现象本身有迷惑性：卡在 Resolving dependencies 几十秒、CPU 拉满、最后抛出模糊的“无法安装 root package”，容易误判为网络或性能问题。但真正线索藏在细节里：

• composer update --dry-run -v 输出末尾反复出现同一组包名（如 vendor/a → vendor/b → vendor/a）
• composer depends --tree vendor/a 返回路径中出现 vendor/a ← vendor/b ← vendor/a（箭头方向是“被谁依赖”，自身出现两次即闭环）
• composer show --tree 里某包同时出现在上游和下游位置
• 本地能装、CI 失败——大概率是缓存了旧 composer.lock 或元数据，先 composer clear-cache 再试

为什么 composer depends --tree 经常查不到闭环

这个命令看似简单，但有两个硬前提没满足就必然失效：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 必须在已成功执行过 composer install 的项目里运行（否则 composer.lock 不完整，依赖图缺失）
• 必须加 --tree 参数（不加只显示一级依赖，根本看不到间接环）
• 如果报 Package not found，说明该包压根没进 composer.lock——它早在解析阶段就被拦截了，不是漏查，是根本没活到构建依赖树那步

autoload + require-dev 是最隐蔽的循环来源

你没在 require 里写互相依赖，但项目照样爆红。原因往往是某个 require-dev 包（比如 phpunit/phpunit、infection/infection）在自己的 composer.json 里写了："autoload": {"psr-4": {"App\": "../src/"}}——它把你的 src/ 加进了自己的自动加载路径；而你的代码又用了它的类（比如测试基类、断言工具），运行时就形成了隐式闭环。

• 检查所有 require-dev 包的 composer.json，搜 ../、../../、src/、tests/ 这类路径
• 临时注释掉非核心 require-dev 条目，尤其是喜欢跨项目 autoload 的工具
• 确认你自己的 autoload-dev 没把 vendor/ 下的路径写进去——这等于告诉 Composer：“我依赖我自己”

破环只有三种有效方式，没有“跳过”选项

删 composer.lock、加 --ignore-platform-reqs、改 minimum-stability，都只是掩盖症状。真正解法必须重构依赖方向：

• 抽离契约包：新建 myorg/contracts，只放接口、DTO、异常；它的 composer.json 中 "require": {} 必须为空；core 和 api 都只 require "myorg/contracts": "^1.0"
• 运行时解耦：A 不再 new B() 或 use BClass，而是定义 LoggerInterface（放在契约包），B 实现它，A 通过容器获取实例；此时 A 的 composer.json 里必须删掉对 B 的 require
• 降级为可选依赖：B 只在 A 的测试里用？移到 require-dev；是增强功能（如导出 Excel）？改用 suggest 字段提示用户手动安装

最容易被忽略的是：契约包发布后，所有引用它的包必须同步升级版本约束，否则旧版仍会试图拉取已被拆走的类——破环不是改一行配置就完事，是整条链路的协同演进。