安装无声明依赖的Composer包时出现依赖冲突问题如何解决？

你开发的包本身没有声明依赖，但是Composer安装新包时会统一校验项目全量依赖的版本兼容性，本次报错的核心冲突逻辑如下：

项目PHP版本为7.4.19，不满足psr/cache 3.0要求的PHP>=8.0；但doctrine/annotations 1.13.1允许安装psr/cache 1/2/3三个大版本，Composer默认优先拉取最高版本，而你项目中l5-swagger被锁定在8.0.7版本无法自动升级适配，最终触发依赖冲突。

• 执行composer show psr/cache查看项目当前已安装的psr/cache版本，如果已安装1.x或2.x版本，说明安装新包时触发了Composer的全量依赖更新逻辑，自动拉取了更高版本的psr/cache
• 检查安装命令是否携带了-u/--update-with-dependencies等会触发全量依赖更新的参数
• 登录私有Packagist后台检查你上传的XXXX/fields包的发布配置，确认是否有误带入require-dev依赖、或平台强制注入额外依赖的情况

临时可用方案 #

安装时限制仅更新目标包，不联动更新其他已安装依赖：

composer require XXXX/fields:^1.0 --update-with-all-dependencies=XXXX/fields

也可以先写入依赖声明不触发更新，再基于已有lock文件安装：

composer require XXXX/fields:^1.0 --no-update
composer install

永久根治方案 #

在项目根目录的composer.json中添加psr/cache的版本约束，强制锁定在兼容PHP7.4的版本：

{
    "require": {
        // 保留原有其他依赖，新增以下行
        "psr/cache": "^2.0"
    }
}

psr/cache 2.x版本兼容PHP>=7.4，完全符合doctrine/annotations 1.13.1的版本要求，调整后再执行安装命令即可正常安装。

额外优化建议 #

你开发的XXXX/fields包可以在composer.json的require字段中添加最低PHP版本约束，比如"php": ">=7.4"，避免后续其他更低PHP版本的环境安装时出现未知兼容问题。

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