Laravel8安装spatie/laravel-medialibrary9.x出现Composer依赖冲突如何解决

核心冲突来自三方包版本约束不匹配：

• Laravel 8 默认依赖的 guzzlehttp/psr7 为2.0+版本，而 spatie/laravel-medialibrary 9.x 依赖的默认 intervention/image 2.x 版本最高只支持 guzzlehttp/psr7 1.x
• Laravel 8 默认依赖的 league/flysystem 为1.x版本，spatie/laravel-medialibrary 9.x 部分底层依赖要求 league/flysystem 2.x，二者版本不兼容
• 加 -W 参数后依旧报错，是因为Composer自动升降级依赖时会触及Laravel框架本身的版本约束，导致框架依赖无法满足

你可以先执行以下命令确认冲突：

• 执行 composer show guzzlehttp/psr7 确认当前版本确实为2.x
• 执行 composer show league/flysystem 确认当前版本确实为1.x
• 执行 composer prohibits spatie/laravel-medialibrary 9.6.4 可直接输出完整的依赖冲突链，验证上述根因是否成立

方案一：手动降级冲突依赖（最稳妥，不影响框架功能） #

Laravel 8 依赖的Guzzle 7本身兼容guzzlehttp/psr7 1.x版本，可先手动降级后再安装扩展：

1. 执行命令降级psr7版本：

composer require guzzlehttp/psr7:"^1.8" -W

2. 再执行medialibrary安装命令即可：

composer require spatie/laravel-medialibrary:"^9.0.0"

方案二：安装高版本兼容依赖 #

intervention/image从2.7版本开始已支持guzzlehttp/psr7 2.x，可先升级该依赖后再安装扩展：

1. 执行命令安装高版本intervention/image：

composer require intervention/image:"^2.7"

2. 再执行medialibrary安装命令即可

方案三：全量适配依赖（仅适用于全新无自定义依赖的项目） #

如果是刚创建的空项目，没有其他自定义依赖，可直接删除composer.lock文件和vendor目录，在composer.json的require字段中手动添加"spatie/laravel-medialibrary": "^9.0.0"，再执行composer install，Composer会自动适配所有依赖的兼容版本。

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