“Your requirements could not be resolved”是Composer SAT求解失败，表明无版本组合能满足全部约束；须用composer why-not定位阻断链，而非删缓存或换镜像。
不是下载失败，是 Composer 拒绝安装——它在解析依赖时发现没有一组版本能同时满足所有约束，包括 PHP 版本、扩展、包间互斥要求。直接删缓存或换镜像没用，得看清楚哪条约束卡住了。
看懂 Your requirements could not be resolved 的真实含义
这个报错不是网络问题，也不是“下不到”，而是 Composer 经过完整依赖图计算后，确认无解。常见诱因有三类：
- PHP CLI 版本低于
composer.json中"php": "^8.1"等声明（注意：Web 服务器的 PHP 版本不相关，composer只认php -v输出） - 某个包在
composer.json里写了"conflict": {"monolog/monolog": "^2.0"}，而你又 require 了monolog/monolog:^2.0 -
composer.lock里锁了高版本依赖（比如 Laravel 10），但本地 PHP 是 7.4，composer install会直接复用 lock 文件，不重新协商
用 composer why-not 定位具体拦路虎
别猜哪个包冲突，让 Composer 自己说。假设你想装 laravel/framework:10.0 却失败，运行：
composer why-not laravel/framework:10.0
输出会明确告诉你：谁在阻止、为什么阻止。典型结果如：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
your-project requires php ^8.1→ 但你php -v是 7.4.33 -
guzzlehttp/guzzle 7.8.0 requires php >=8.0→ 而laravel/framework:10.0依赖它 -
monolog/monolog 1.27.0 conflicts with laravel/framework[10.0]→ 冲突字段生效
看到具体包和版本后，再决定是降级 Laravel、升级 PHP，还是换掉那个冲突包。
临时绕过平台限制要分清场景
--ignore-platform-reqs 和 config.platform.php 都是“假装环境达标”，但风险不同：
-
composer install --ignore-platform-reqs：跳过所有平台检查（PHP 版本、扩展），仅用于本地快速验证能否跑通，**绝对不可进 CI 或生产** -
"config": {"platform": {"php": "8.1.0"}}：只影响composer update阶段的依赖选择，不影响运行时；但若你代码真用了 PHP 8.1+ 的语法（如枚举、match），在 PHP 7.4 下仍会ParseError - 二者都不能解决
conflict字段导致的硬性排斥，那必须改依赖或换包
重装旧版本必须先清理约束残留
想装 monolog/monolog:1.27.0 却报错？不是 Composer 不让，是你没清除原有约束：
- 别直接
composer require monolog/monolog:1.27.0—— 如果composer.json里还留着"laravel/framework": "^10.0"，Composer 会坚持找一个既满足 Laravel 10 又兼容 Monolog 1.27 的解，而它不存在 - 正确顺序：
composer remove laravel/framework→composer require monolog/monolog:1.27.0→ 再按需加回兼容旧版的 Laravel（如^8.75） - 如果
composer.lock已存在，且含 Composer 2.x 特性字段，降级到 Composer 1 后必须先composer install（不是update），否则解析失败
最常被忽略的一点：冲突往往不在你想动的那个包上，而在它上游的某个间接依赖里。不查 composer depends 和 composer why-not，光改版本号只是反复撞墙。
