间接依赖冲突是composer在resolve阶段发现的传递路径上不可调和的版本断点，需用composer show --tree查链路、composer why-not指定版本定位约束、composer depends -r追溯强制依赖源。
间接依赖冲突不是“看不见的 bug”，而是 Composer 在 resolve 阶段发现某条传递路径上出现了不可调和的版本断点——比如你没写 monolog/monolog，但 laravel/framework 依赖它，而 phpunit/phpunit 又悄悄要求另一个不兼容的 monolog 版本。
为什么 composer show --tree 是查间接冲突的第一步
间接冲突藏在第二、三层依赖里，composer.json 根本不体现。用 composer show --tree 能展开整条链路，看到谁在哪个层级引入了哪个版本：
- 输出中每行末尾带
(locked to 1.25.0)的，说明这个版本已被composer.lock固定，可能早就是历史妥协结果 - 如果某包在树里出现多次、且版本不同（比如
symfony/console一次是^5.4，另一次是^6.0），那它大概率就是冲突枢纽 - 配合
grep快速过滤：例如composer show --tree | grep -A2 -B2 "monolog"，能跳过无关分支，直击关键节点
composer why-not 必须带完整包名+版本号才有效
它不分析“当前装了什么”，而是模拟“你想装这个却失败”的场景。不指定版本，它就无从判断哪里卡住：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 错误写法：
composer why-not monolog/monolog→ 报[InvalidArgumentException] Package not found - 正确写法：
composer why-not monolog/monolog:^2.0→ 它会列出所有阻止该版本安装的约束，例如：laravel/framework v8.75.0 requires monolog/monolog ^1.25 - 若目标版本根本不在 Packagist 上发布过，
why-not也会静默失败，此时先用composer show monolog/monolog确认可用版本列表
require-dev 是最常被忽略的间接冲突源
开发期工具包（如 phpunit/phpunit、larastan/larastan）虽标为 require-dev，但它们的子依赖仍参与全局解析。一个典型现象是：删掉 phpunit 后 composer update 突然成功。
- 验证方法：运行
composer update --no-dev --dry-run -v，如果不再报错，说明冲突来自 dev 分支 - 更细粒度排查：
composer show --tree phpunit/phpunit，重点扫它依赖的sebastian/*、phpspec/prophecy等，这些常与主业务包的symfony/*版本打架 - 临时绕过：
composer install --no-dev可用于生产环境部署，但本地调试时务必保留--with-all-dependencies，否则隐藏冲突不会暴露
用 composer depends -r 找出真正的“版本卡手人”
当你发现某个包被锁在旧版（如 guzzlehttp/guzzle 停在 7.2.0），depends -r 能直接告诉你谁在强制它不能升：
-
composer depends -r guzzlehttp/guzzle输出中，带requires的行才是硬性约束来源；带replaces或provides的可忽略 - 注意符号差异：
^7.2允许7.9.9，但~7.2.0只允许7.2.x，这两个看似接近，却是很多“明明写了宽松约束却升不了”的真实原因 - 如果输出里出现
your-project（即根项目），说明你在composer.json里手动锁死了版本，得回头检查require或require-dev字段
间接冲突最难 debug 的地方在于：它不报错在表层，而是在 Composer 内部 SAT 求解器回溯时悄悄排除了一整个版本分支。所以别信“应该没问题”，每个 show、why-not、depends 命令都要带参数跑一遍，漏掉任意一个环节，就可能把问题归因到错误的包上。
