“Your requirements could not be resolved”是依赖约束冲突所致，需用composer why-not定位阻断链、composer show --tree查真实依赖结构，再通过composer update --with-dependencies或写死版本精准修复，而非删lock文件或换镜像。
升级 Laravel 11 时 Composer 报 “Your requirements could not be resolved” 或卡在 Dependency resolution failed，不是网络慢或权限错，而是你当前依赖图里存在无法同时满足的版本约束——比如某包硬性要求 guzzlehttp/guzzle ^8.0，而另一包锁死在 ^7.4.5，两者根本不能共存。
第一步：确认冲突源头在哪
别看报错堆栈最上面那行，直接运行：
composer why-not laravel/framework:11.0.0
输出是一条反向阻断链，必须从最后一行倒着读。最后一行是你 composer.json 里的根声明（例如 myapp dev-main requires laravel/framework:^11.0），往上每一行末尾的 (required by) 是向上追溯的起点。找到某两行同时提到同一个包但版本范围互斥，比如：
package-a v2.1 requires guzzlehttp/guzzle ^7.0
package-b v3.0 requires guzzlehttp/guzzle ^8.0
冲突点就落在 guzzlehttp/guzzle 上。
如果输出为空，说明问题大概率藏在 require-dev 里——比如 phpunit/phpunit 拖着旧版 symfony/console，它不会出现在主依赖链中，但会参与求解。
第二步：查真实依赖结构，别信 composer.json
运行：
composer show --tree | grep "guzzlehttp/guzzle"
这显示的是 vendor/ 和 composer.lock 的真实快照，不是你 composer.json 里写的“愿望清单”。它能暴露你根本没意识到的间接路径——比如 monolog/monolog → guzzlehttp/guzzle → psr/http-client，而另一个包走的是 league/flysystem → guzzlehttp/guzzle → psr/http-factory，两条路径锁定了不同版本。
树太深？用过滤命令聚焦关键段：
composer show --tree monolog/monolog | grep -A5 -B5 "guzzlehttp/guzzle"
看到某包标着 (replaced) 或 (provided)，得去它 composer.json 里确认是否真能等价——很多“替代包”只是接口兼容，内部实现已删掉你正在调用的方法。
第三步：定点升级或降级，避开全量重算
方法一：升级冲突包的上游依赖
先运行 composer outdated，找出明显落后的核心包（如 symfony/console 卡在 6.4，而 Laravel 11 要求 ≥7.0）。再单独升级：
composer update symfony/console --with-dependencies
方法二：降级新引入包的主版本
如果你只是想装 laravel/framework:11.0.0，但被 phpunit/phpunit 挡住，试试更低主版本：
composer require phpunit/phpunit:^9.6
方法三：写死冲突依赖版本
降级跨主版本（如从 ^8.0 切回 7.4.5）必须在 composer.json 里写死：
"guzzlehttp/guzzle": "7.4.5"
【不能只写 "^7.0"】——否则 Composer 仍可能选 7.9.0，而该版本与 Laravel 11 的某个子依赖不兼容。
执行后立刻 git diff composer.lock，确认只有目标包及其直系依赖被改。全量 composer update 容易触发 SAT 求解器卡死，尤其项目依赖多时。
第四步：绕过平台限制（仅限开发验证）
如果报错明确指向 PHP 版本或扩展缺失（如 Your requirements could not be resolved because you have a platform requirement like "php": "^8.2"），可临时跳过：
composer update --ignore-platform-reqs
但注意：【--ignore-platform-reqs 不解决包间依赖冲突】——它只绕过 PHP 版本、扩展等环境校验，对 guzzlehttp/guzzle 版本矛盾完全无效。
想精准忽略某一项？用单数参数：
composer update --ignore-platform-req=php
多个要忽略的，重复写参数：
composer update --ignore-platform-req=php --ignore-platform-req=ext-gd
第五步：强制重装并验证锁定文件
第一步：删 vendor 目录和 composer.lock 文件
第二步：运行：
composer install --no-dev --ignore-platform-reqs
这会基于当前 composer.json 重新生成 composer.lock，但跳过 require-dev 里的干扰项（如 phpunit、pest 等测试工具）。
第三步：确认 Laravel 11 核心依赖全部安装成功后，再补装开发依赖：
composer require --dev phpunit/phpunit:^10.0 --with-dependencies
执行后立刻 git diff composer.lock，确认只有 phpunit 及其直系依赖被加入，没有意外带进其他包。
