composer why-not定位阻断源，倒查required by路径与conflict with封杀点，结合--with-dependencies升级并核验composer.lock变更，警惕config.platform和conflict字段的隐性拦截。
大型模块化项目里出现依赖冲突，不是配置写错了，而是约束交集被实际依赖链切碎了——composer update 卡在 Resolving dependencies 超过 2 分钟，基本可以确定是 SAT 求解器在暴力回溯，而不是网络或磁盘慢。
用 composer why-not 定位真正阻断源，别信报错第一行
报错里写的 Conclusion: don't install monolog/monolog:2.10.0 是结果，不是原因。真正要读的是 composer why-not monolog/monolog:2.10.0 输出的最后一行（即你的根项目 myapp/myproject dev-main 的 require），然后往上倒着看：每行末尾的 (required by ...) 是向上追溯路径，中间夹着的 conflict with ... 才是硬性封杀点。
常见误判：
- 看到某行写
symfony/console (>=6.0)就去查 console —— 其实它只是被laravel/framework v10.32.0要求，而冲突源头可能是package-x v2.1声明了"conflict": {"symfony/console": ">=6.0"} - 忽略
require-dev包：比如phpunit/phpunit锁死了symfony/yaml ^5.4，而你主应用要升symfony/yaml ^6.4，冲突就在这里爆发
定点升级必须带 --with-dependencies，否则大概率失败
composer update vendor/package 单独执行，Composer 默认只更新该包本身，不碰它的子依赖。但现实中，你要升的包往往依赖一个已被其他分支锁死的中间件（比如 monolog/monolog 升级需要 psr/log >= 2.0，而当前 psr/log 是 1.2.0 且被另一个包硬性要求）。
正确做法是：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 显式写全包名：
composer update monolog/monolog --with-dependencies（不能加引号、不能带^） - 升级后立刻
git diff composer.lock，确认只有monolog/monolog及其直系依赖（如psr/log、php约束）被改，其他无关分支（如phpunit/*、mockery/mockery）没动 - 如果仍失败，说明
--with-dependencies暴露出了新冲突包，立刻对它再跑一次composer why-not
别删 composer.lock，它不是问题，是唯一线索
大型模块化项目中，composer.lock 记录的是当前可运行状态。盲目删除它，等于让 Composer 在没有历史锚点的情况下，从零重算数百个包的版本组合——这不仅可能引入更隐蔽的运行时问题（比如某个 symfony/polyfill-* 版本差异导致 mb_strlen() 行为突变），还会掩盖谁在什么时候把约束写窄了。
更稳妥的做法：
- 先
composer install --dry-run，看是否仅因本地环境（PHP 版本、扩展缺失）触发校验失败 - 若确认要调整，优先改
composer.json中的约束：比如把"monolog/monolog": "^2.8"改成"^2.8 || ^3.0"（前提是代码已适配），再composer update monolog/monolog - 团队协作中遇到拉代码后冲突，先
git checkout -- composer.lock恢复上一版 lock，再composer install；若需同步更新，由提交composer.json的人连带提交新的composer.lock
config.platform 和 conflict 字段常被低估，但它们会静默封杀整条路径
很多冲突根本不出现在依赖树里，而是被 config.platform 或 conflict 直接拦截。例如：
-
"config": {"platform": {"php": "7.4.33"}}写死 PHP 版本，但某个新包要求php >=8.1，Composer 连版本候选都不列，直接报“no matching package found” - 私有模块写了
"conflict": {"laravel/framework": ">=11.0"}，哪怕你项目里没装 L11，只要某个间接依赖（比如spatie/laravel-backup新版）悄悄拉入了laravel/framework的dev-main快照，整个解析就会崩
检查方式：
-
composer config platform查当前模拟平台 -
composer show -t | grep -A5 -B5 conflict快速扫一遍所有已装包是否声明了冲突规则 - CI 环境务必加
COMPOSER_MEMORY_LIMIT=-1和--dry-run预验证，避免上线前才发现
复杂点不在命令多难记，而在每个 composer.json 里的 conflict、replace、platform 都可能成为跨模块的隐性开关——它们不报错，但会让依赖图在某个分支上彻底断开。定位时得一层层剥，不能只盯着报错里最显眼的那个包名。
