league/flysystem-aws-s3-v3与Laravel 10兼容冲突，安装失败求助

当前composer.json配置 #

"require": {
    "php": "^8.1",
    "guzzlehttp/guzzle": "^7.2",
    "laravel/framework": "^10.10",
    "laravel/sanctum": "^3.2",
    "laravel/tinker": "^2.8",
    "symfony/http-client": "^6.3",
    "symfony/mailgun-mailer": "^6.3",
    "twilio/sdk": "^7.5"
},
"require-dev": {
    "fakerphp/faker": "^1.9.1",
    "laravel/pint": "^1.0",
    "laravel/sail": "^1.18",
    "mockery/mockery": "^1.4.4",
    "nunomaduro/collision": "^7.0",
    "phpunit/phpunit": "^10.1",
    "spatie/laravel-ignition": "^2.0"
}

问题重现 #

执行以下命令安装S3相关包：

composer require league/flysystem-aws-s3-v3

出现依赖冲突错误：

Problem 1
    - league/flysystem-aws-s3-v3[3.12.1, ..., 3.15.0] require aws/aws-sdk-php ^3.220.0 -> satisfiable by aws/aws-sdk-php[3.220.0, ..., 3.275.9].
    - league/flysystem-aws-s3-v3[3.0.0, ..., 3.10.3] require aws/aws-sdk-php ^3.132.4 -> satisfiable by aws/aws-sdk-php[3.132.4, ..., 3.275.9].
    - league/flysystem-aws-s3-v3[1.0.0, ..., 1.0.13] require league/flysystem ~1.0 -> found league/flysystem[1.0.0, ..., 1.1.10] but the package is fixed to 3.15.1 (lock file version) by a partial update and that version does not match. Make sure you list it as an argument for the update command.
    - league/flysystem-aws-s3-v3[1.0.15, ..., 1.0.30] require league/flysystem ^1.0.40 -> found league/flysystem[1.0.40, ..., 1.1.10] but the package is fixed to 3.15.1 (lock file version) by a partial update and that version does not match. Make sure you list it as an argument for the update command.
    - league/flysystem-aws-s3-v3[2.0.0, ..., 2.5.0] require league/flysystem ^2.0.0 -> found league/flysystem[2.0.0, ..., 2.5.0] but the package is fixed to 3.15.1 (lock file version) by a partial update and that version does not match. Make sure you list it as an argument for the update command.
    - aws/aws-sdk-php[3.131.0, ..., 3.173.19] require guzzlehttp/psr7 ^1.4.1 -> found guzzlehttp/psr7[1.4.1, ..., 1.9.1] but the package is fixed to 2.5.0 (lock file version) by a partial update and that version does not match. Make sure you list it as an argument for the update command.
    - aws/aws-sdk-php[3.173.20, ..., 3.198.8] require guzzlehttp/psr7 ^1.7.0 -> found guzzlehttp/psr7[1.7.0, ..., 1.9.1] but the package is fixed to 2.5.0 (lock file version) by a partial update and that version does not match. Make sure you list it as an argument for the update command.
    - aws/aws-sdk-php[3.199.0, ..., 3.275.9] require guzzlehttp/promises ^1.4.0 -> found guzzlehttp/promises[1.4.0, ..., 1.5.3] but the package is fixed to 2.0.0 (lock file version) by a partial update and that version does not match. Make sure you list it as an argument for the update command.
    - Root composer.json requires league/flysystem-aws-s3-v3 * -> satisfiable by league/flysystem-aws-s3-v3[1.0.0, ..., 1.0.30, 2.0.0, ..., 2.5.0, 3.0.0, ..., 3.15.0].

Use the option --with-all-dependencies (-W) to allow upgrades, downgrades and removals for packages currently locked to specific versions.
You can also try re-running composer require with an explicit version constraint, e.g. "composer require league/flysystem-aws-s3-v3:*" to figure out if any version is installable, or "composer require league/flysystem-aws-s3-v3:^2.1" if you know which you need.

注：尝试使用--ignore-platform-reqs参数后，错误仍未解决。

解决方法 #

方法1：使用--with-all-dependencies参数强制更新依赖 #

Composer提示的-W（即--with-all-dependencies）参数允许Composer更新当前锁定版本的依赖包，自动解决版本冲突。执行以下命令：

composer require league/flysystem-aws-s3-v3 -W

方法2：指定兼容的版本约束 #

由于当前项目锁定的league/flysystem版本是3.15.1，可直接指定3.x系列的flysystem-aws-s3-v3版本：

composer require league/flysystem-aws-s3-v3:^3.0

若仍有冲突，结合-W参数使用：

composer require league/flysystem-aws-s3-v3:^3.0 -W

方法3：清理锁文件重新安装（谨慎操作） #

如果上述方法无效，可删除锁文件和依赖目录，重新计算所有依赖的兼容版本：

rm composer.lock
rm -rf vendor
composer install
composer require league/flysystem-aws-s3-v3

此操作会更新其他包的版本，需确认项目能接受这些变更。

内容的提问来源于stack exchange，提问作者Libra Ramis