composer 遇到循环依赖直接报错退出，因sat求解器确认了a→b→a逻辑闭环；关键证据是嵌套的“depends on”描述或“root package cannot be installed”卡在解析超30秒。
Composer 遇到循环依赖不会“卡住然后重试”，它直接报错退出——这不是网络慢或缓存脏，是 SAT 求解器确认了 A → B → A 这种逻辑闭环，拒绝生成不可拓扑排序的依赖图。
报错里反复出现 “depends on” 就是实锤
别只扫一眼第一行错误。真正关键的是嵌套描述：Package a depends on b, which depends on a，或者更隐蔽的变体：Root package cannot be installed + 卡在 Resolving dependencies 超 30 秒且无网络日志。这时不是 Composer 在“努力解析”，是它在死循环里打转。
常见误判点：
- 把
composer validate当诊断工具——它只校验 JSON 格式，对循环依赖完全无感 - 看到
composer show输出正常就以为没问题——它默认包含require-dev，会掩盖真实生产依赖路径 - 执行
composer update --dry-run不加-v——没 verbose 日志，根本看不到包之间来回跳转的痕迹
用 composer depends --tree 定位闭环链路
这是唯一能实锤闭环的命令，但有两个硬前提必须满足：项目已成功执行过 composer install（保证 composer.lock 有完整快照），且必须带 --tree 参数。不加就只显示一级依赖，看不出间接环。
实操要点：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 如果提示
Package not found，说明该包连进composer.lock的机会都没有——先删掉vendor/和composer.lock，再跑composer update --dry-run -v观察第一步失败点 - 输出中看到
myorg/core ← myorg/api ← myorg/core这类结构就是闭环（箭头方向是“被谁依赖”，同一包名出现两次） - 重点检查
require-dev下的包：比如phpunit/phpunit的composer.json里写了"autoload": {"psr-4": {"App\": "../src/"}}，就把你的src/加进了它的自动加载路径，而你的代码又用了它的类，形成运行时闭环
临时注释 require-dev 是最快验证手段
80% 的“循环依赖”报错其实来自开发依赖反向污染。它们本不该参与生产依赖图，但因 autoload 或 CI 脚本误启，悄悄打通了回路。
操作建议：
- 临时注释掉
require-dev下所有非核心工具（phpunit/phpunit、phpstan/phpstan、infection/infection） - 再执行
composer update --dry-run -v，如果不再反复跳转，问题就在这里 - 逐个恢复
require-dev条目，配合composer depends --tree vendor/package-name看哪个包的依赖树意外拉入了上游 - 检查所有
require-dev包的composer.json，搜"../src"、"../../myproject/src"这类路径
破环只有三种有效方式，没有“跳过”选项
任何 --force、--ignore-platform-reqs 或手动改 vendor/ 都只是掩盖问题，下次更新照样崩。所有靠谱方案都指向一个目标：让依赖方向变成单向。
可选路径：
- 抽离契约包：新建
myorg/contracts，composer.json中"require": {}为空，只定义接口、DTO、异常；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；若 B 确需运行时存在，就别放在require-dev里还让其他包通过 autoloading 间接依赖它
最常被忽略的是 autoload 层面的隐式循环——它不会出现在 composer show --tree 里，但会真实阻塞解析。这类问题必须靠手动验证 autoload 路径是否越界，而不是等 Composer 给你提示。
