Composer循环依赖可立即确认：报错“Root package cannot be installed”且--dry-run -v卡在Resolving dependencies超30秒、CPU拉满，或输出反复出现同一组包≥3次，或composer show -t显示某包通过不同路径引入≥3次，或composer depends --tree实锤闭环链路。
Composer 遇到循环依赖直接中止，不降级、不跳过、不忽略——它用 SAT 求解器检测到 A → B → A 这类路径就认定依赖图逻辑不可解，必须人工破环。
怎么一眼确认是循环依赖，不是版本冲突
别等终端卡住 60 秒再怀疑。看到以下任意一种现象，基本可以锁死是循环依赖：
-
Root package cannot be installed报错，且composer update --dry-run -v卡在Resolving dependencies超 30 秒，CPU 持续拉满 - 报错信息里明确出现
Package a depends on b, which depends on a -
composer update --dry-run -v输出末尾反复跳转同一组包，比如vendor/a → vendor/b → vendor/a出现 ≥3 次 -
composer show -t --no-dev中某个包名在同一棵树里出现 ≥3 次，且父级路径完全不同（如通过c、d、e三条不同路径被引入）
用 composer depends --tree 定位闭环链路
这是目前唯一能实锤闭环的命令，但有两个硬前提必须满足，否则输出全是假阴性：
- 项目必须已成功执行过
composer install（确保composer.lock有完整快照） - 必须加
--tree参数，否则composer depends vendor/a只显示一级上游，根本看不到间接环
查可疑包时，运行：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer depends myorg/core --tree
如果输出含 myorg/core ← myorg/api ← myorg/core，箭头方向是“被谁依赖”，自身出现两次即闭环实锤。若提示 Package not found，说明该包压根没进 composer.lock，先执行 composer clear-cache，再删 vendor/ 和 composer.lock，重试 composer update --dry-run -v 看第一步失败点。
最容易被忽略的隐式循环：require-dev + autoload
你没在 require 里写互引，但 Composer 依然报错？大概率是 require-dev 包通过自动加载“反向加载了你的代码”，而你的代码又用了它的类，形成运行时闭环。
- 检查所有
require-dev包的composer.json，重点搜"../src"、"../../myproject/src"、"App\": \"../src/\"这类路径 - 临时注释掉非核心
require-dev条目（如phpunit/phpunit、phpstan/phpstan、infection/infection），再试composer update - 确认你自己的
autoload-dev没把vendor/下的路径写进去——这等于告诉 Composer：“我依赖我自己” - 检查
repositories字段，确认没有{"type": "path", "url": "."}这类指向当前项目的配置
真正有效的破环方式只有三种，没有“跳过”选项
所有临时手段（删 composer.lock、加 --ignore-platform-reqs、改 minimum-stability）都只是掩盖症状。真正解法必须重构依赖方向，让关系变成单向：
-
抽离契约包：新建
myorg/contracts，只放接口、DTO、异常，其composer.json中"require": {}为空；myorg/core和myorg/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字段提示用户手动安装
闭环最常藏在 autoload 和 require-dev 的交界处，而不是 require 字段里——这点最容易被跳过，也最难排查。
