该错误是依赖约束互斥导致无法找到满足全部要求的版本组合，非网络或权限问题；应使用composer why定位冲突包、composer why-not查阻塞链、composer update加--with-all-dependencies精准更新。
直接看报错里冲突的包名和版本范围，别先急着删 composer.lock 或全量 update。
查清楚谁在拉扯同一个依赖
冲突本质是两个（或多个）包对同一依赖提出了互斥的版本要求。比如 monolog/monolog 被 A 包要求 ^2.0，又被 B 包要求 ^1.25，Composer 就卡住不动。
- 运行
composer why monolog/monolog，看哪些包把它带进来、各自约束了什么版本 - 加
-r参数（composer why -r monolog/monolog）还能看到递归依赖链，定位到最底层的“始作俑者” - 如果输出里出现
dev-master或*这类模糊约束，基本就是根源——它们会干扰 SAT 求解器的判断
用 update 精准松动某一个包
全局 composer update 容易引发连锁反应，反而扩大冲突面。优先尝试只更新“问题包”本身及其直系依赖：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer update vendor/package-name --with-all-dependencies（Composer 2.2+）强制重算它的整个子树 - 如果知道目标包能兼容更高版依赖，直接指定：
composer update monolog/monolog:^3.0 - 想临时绕过某个约束测试可行性？用
--with：composer update --with=monolog/monolog:^3.0 - 加
--dry-run -v先预演，看它打算怎么改，避免盲操作
检查 composer.json 里的约束写法是否合理
很多冲突其实源于本地 composer.json 写了过于宽松或矛盾的约束，比如同时写了 "package-a": "^1.0" 和 "package-b": "~2.0"，而这两个包又都依赖同一个底层库。
- 把
*、dev-前缀、branch-alias全换成语义化版本，如^2.5或~2.5.0 - 确认 PHP 版本声明（
"php": "^8.1"）和所有依赖的require.php范围不打架，PHP 版本不匹配常被忽略但杀伤力极强 - 如果用了
merge-plugin，检查extra.merge-plugin.include里合并的多个composer.json是否存在同名包的不同版本声明
锁文件损坏或合并冲突时别硬修
Git 合并时 composer.lock 出现 composer diagnose 报 “lock file is not up to date”，这时候手动删标记、改哈希值极易出错。
- 先执行
composer update --lock，它会基于当前composer.json重新生成合法锁文件，覆盖冲突标记 - 如果
vendor/已损坏但composer.lock完好，直接composer install即可恢复，不用重跑update - 实在无法解析，清缓存再试：
composer clear-cache && composer update --prefer-dist，缓存脏数据有时会让求解器陷入死循环
真正难搞的往往不是报错信息本身，而是某个包的 composer.json 里写了 "conflict": {"other/package": " 这种硬性排除规则，它不会出现在 <code>why 输出里，得去 GitHub 上翻源码看 —— 这类隐式冲突最容易漏掉。
