卡在“resolving dependencies through sat”即为sat求解器暴力回溯逻辑冲突，非网络或缓存问题；用composer update -vvv --profile定位停驻点，若卡在此处且超3分钟，说明约束不可满足，需用composer why-not或prohibits定位阻断链。
Composer依赖解析卡在“Resolving dependencies”怎么确认是引擎错误
这不是网络或缓存问题，而是 SAT 求解器在尝试满足所有约束时陷入逻辑死锁。只要日志里出现 Resolving dependencies through SAT 并持续卡住（尤其超 3 分钟），基本可判定是约束不可满足，不是引擎 bug，而是项目配置矛盾。
用 composer update -vvv --profile 看最后停驻点：如果卡在 SAT 阶段，说明求解器正在暴力回溯组合；如果卡在 Reading /packages.json from cache 或 Downloading，才是镜像/网络层问题。
- 反复出现同一包名（如
symfony/event-dispatcher、psr/log）在不同版本间跳转，是典型冲突枢纽信号 -
composer update --dry-run -v输出末尾的 “Because…” 句式，直接暴露冲突链起点和终点 - 别信“在我机器上能跑”——PHP 版本、
platform配置、甚至require-dev里的phpunit/phpunit都会参与求解，且权重不低
为什么 composer why-not vendor/package:version 比看报错更准
报错只告诉你“装不了”，why-not 告诉你“谁亲手按住了你的手”。它从目标版本出发，逆向遍历整个依赖图，把每一层阻断关系摊开成可读路径。
例如运行 composer why-not monolog/monolog:2.10.0，输出可能是：
my-project requires monolog/monolog (^1.25) laravel/framework[v10.42.0] requires monolog/monolog (^2.8) spatie/laravel-backup[v8.5.0] requires monolog/monolog (^1.25)
这说明 my-project 和 spatie/laravel-backup 共同锁死了 ^1.25，而 laravel/framework 虽然兼容 2.x，但被前者拖住无法升。
- 必须写全版本号，
composer why-not monolog/monolog:2.10.0有效，composer why-not monolog/monolog会报[InvalidArgumentException] Package not found - 若输出含
your-project，说明根composer.json里写了硬约束或conflict字段，不是第三方锅 -
require-dev包同样出现在结果里——phpunit/phpunit:^9.6要求 PHP 8.1+，但项目设了"platform": {"php": "7.4"}，就会被列出来
composer prohibits 是查“谁在封杀我”的反向工具
当你想确认某个包为什么不能升级，又不确定该查谁，prohibits 就是探针。它不从你出发，而是问：“当前已安装/锁定的所有包里，哪些明确拒绝这个版本？”
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
比如 composer prohibits guzzlehttp/guzzle:^8.0 可能返回：
laravel/framework[v9.52.16] requires guzzlehttp/guzzle (^7.2) orchestra/testbench[v7.26.0] requires guzzlehttp/guzzle (^7.5)
这就比翻十几个 composer.json 快得多。
- 它只检查已解析成功的 lock 文件内容，所以必须先有可用的
composer.lock；刚删完 lock 直接跑会报空 - 结果里没出现的包，不代表完全兼容——只是没写明
conflict或没在 require 中显式声明排斥 - 搭配
--tree用（composer prohibits guzzlehttp/guzzle:^8.0 --tree）能看到每条阻断路径的完整依赖链
调整版本约束前必须验证的三个边界
盲目把 ^1.0 改成 ^2.0 可能直接让项目启动失败。主版本升级不是语义化版本说了算，得看实际兼容性。
先查清楚目标包在你要升的版本里到底改了啥：
- 跑
composer show vendor/package x.y.z，重点看require字段是否引入新依赖（比如guzzlehttp/guzzle:^8.0要求php:>=8.0） - 查该包的 CHANGELOG 或 GitHub Releases，确认是否有 BC break —— 尤其注意
Removed和Deprecated条目 - 用
composer depends --tree vendor/package看谁在用它，再逐个查这些“上游”包的文档，确认它们是否声明支持目标版本
真正容易被忽略的是 platform 配置和 conflict 字段。一个没写进 composer.json 的 "platform": {"php": "8.1"}，可能让所有要求 PHP 8.2 的包直接出局；而 "conflict": {"symfony/console": ">=6.0"} 这种硬封杀，不会在 require 阶段预警，只在 SAT 阶段突然断掉整条链。
