Composer依赖循环错误需结构破环：表现为Resolving dependencies超时、错误提示双向依赖、--dry-run回溯同一路径、--tree显示自身闭环；根源常在autoload越界或require-dev反向加载，解法唯三——抽离契约包、运行时解耦、降级为可选依赖。
Composer 遇到依赖循环错误时不会尝试绕过、降级或忽略，它直接中止解析并报错——这不是配置问题，而是依赖图在逻辑上不可解，必须从结构上打破闭环。
怎么一眼确认是循环依赖，不是版本冲突
看到这些现象，基本可以锁死是循环依赖：
-
Root package cannot be installed且卡在Resolving dependencies超过 30 秒（SAT 求解器正在死循环） - 错误信息里明确出现
Package a depends on b, which depends on a - 执行
composer update --dry-run -v，末尾反复回溯同一组包路径，比如vendor/a → vendor/b → vendor/a -
composer show --tree或composer depends --tree vendor/a输出中出现vendor/a ← vendor/b ← vendor/a（箭头表示“被谁依赖”，自身出现两次即闭环）
注意：composer validate 完全没用，它只校验 JSON 格式；composer show 默认带 require-dev，会掩盖真实生产依赖路径。
为什么 composer depends --tree 经常查不到包
这个命令有硬性前提，缺一不可：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 项目必须已成功运行过
composer install（保证composer.lock包含完整依赖快照） - 必须加
--tree参数，否则只显示一级依赖，看不到间接环 - 如果报
Package not found，说明该包根本没进composer.lock，大概率被解析阶段提前拦截了——此时先运行composer clear-cache，再删掉vendor/和composer.lock，重试composer update --dry-run观察第一步失败点
别只查一级依赖。A → C → B → A 这类三层闭环，不加 --tree 就完全看不见。
最容易被忽略的隐式循环：autoload + require-dev
很多“循环”根本不是 require 写错了，而是开发依赖悄悄污染了主依赖图：
- 检查所有
require-dev包的composer.json，重点搜"../src"、"../../myproject/src"、"tests/"这类路径——它们通过autoload把你的代码加进了自己的加载路径 - 你的代码又用了它的类（比如在测试中
use PHPUnit\Framework\TestCase），而它的autoload又加载了你的src/，形成运行时闭环 - 确认你自己的
autoload-dev没把vendor/下的路径写进去——这等于告诉 Composer：“我依赖我自己” - 临时注释掉非必要
require-dev条目，尤其是infection/infection、phpstan/phpstan、phpunit/phpunit这类喜欢跨项目 autoload 的工具
真正有效的破环方式只有三种，没有“跳过”选项
所有临时手段（删 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 的反向加载——它们不会出现在 composer.json 的 require 字段里，却实实在在参与了依赖图构建。
