Composer遇到循环依赖直接拒绝解析，本质是SAT求解器在闭环中无限回溯，表现为CPU持续95%+、内存飙升、终端卡住后退出；需用composer update --dry-run -v观察末尾反复出现的同一路径（如vendor/a → vendor/b → vendor/a）确认闭环，再通过composer depends --tree定位实锤链路（如myorg/core ← myorg/api ← myorg/core），并以抽离契约包、运行时解耦或降级为可选依赖三种方式结构破环。
Composer 遇到循环引用不会“尝试解开”，它直接拒绝生成依赖图——所谓“深度递归调用”其实是 SAT 求解器在闭环里无限回溯，表现为 CPU 持续 95%+、内存每秒涨 50MB+、终端卡住几十秒后突然退出，而不是 PHP 层面的函数栈溢出。
composer update --dry-run -v 的末尾输出就是求解器“临终遗言”
这个命令不改任何文件，但完整走一遍依赖解析流程。关键不是看开头报错，而是盯最后 5–10 行：
- 反复出现同一组包路径（如
vendor/a→vendor/b→vendor/a）就是强信号 - 看到
Rejecting vendor/b because it requires vendor/a ^2.0，而当前锁的是vendor/a:1.9，说明版本约束在环内互相拉扯 - 某个包名（如
myorg/core）连续出现 ≥3 次，且父级不同，大概率是 A→C→B→A 这类多跳环
composer depends --tree 是唯一能实锤闭环的命令
但它有两个硬前提必须满足：项目已有有效的 composer.lock，且命令必须带 --tree 参数。否则只显示一级依赖，完全漏掉间接环：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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——先删vendor/和composer.lock，再跑composer update --dry-run -v看第一步失败点 - 别只查
composer depends myorg/core（无--tree），那只是上游快照，看不出链路折叠
require-dev 中的 autoload 是 80% 隐式循环的源头
最常被忽略的“循环”根本不在 require 字段里，而是测试工具通过自动加载把你的代码反向拉进了它的运行时上下文：
- 检查所有
require-dev包的composer.json，重点搜../、../../、src/、tests/——比如phpunit/phpunit的"autoload": {"psr-4": {"App\": "../src/"}}就会让它加载你的src/ - 确认你自己的
autoload-dev没把vendor/下的路径写进去，这等于告诉 Composer：“我依赖我自己” - 临时注释掉
phpunit/phpunit、infection/infection等喜欢跨目录 autoload 的 dev 工具，再试composer update --dry-run -v；如果不再反复跳转，问题就在这里
抽离公共契约是唯一可持续的破环方式
所有“绕过”“强制安装”“删 lock 重试”都是临时补丁，真正解决问题得从结构上切断闭环：
- 把双方共用的东西拎出来，建一个新包，比如
myorg/contracts，里面只放接口、DTO、异常，"require": {}为空 -
core和api都只require "myorg/contracts": "^1.0"，彻底消除彼此间的直接或间接 require - 严禁用
replace或provide伪装兼容——它们骗不过 SAT 求解器，只会让下次更新更难诊断
真正难的不是找到闭环，而是确认哪个包的 autoload 路径偷偷把你拉进了它的依赖链；很多 composer depends --tree 看不出的环，就藏在 vendor/phpunit/phpunit/composer.json 里那一行 "../src/" 里。
