npm依赖解析失败求助：@awesome-cordova-plugins版本冲突

错误原因分析 #

从报错日志可明确：

• 项目package.json中声明@awesome-cordova-plugins/file为^6.3.0，但npm解析时实际拉取了5.46.0版本
• 该5.x版本的file插件要求peer依赖@awesome-cordova-plugins/core@^5.1.0，但项目已安装core@6.3.0，版本不兼容导致依赖冲突

解决步骤 #

1. 统一@awesome-cordova-plugins系列包版本 #

修改package.json中所有@awesome-cordova-plugins开头的依赖版本，确保完全一致（设为6.3.0，去掉^锁定版本）：

"@awesome-cordova-plugins/core": "6.3.0",
"@awesome-cordova-plugins/file": "6.3.0",
"@awesome-cordova-plugins/file-opener": "6.3.0",
"@awesome-cordova-plugins/in-app-purchase-2": "6.3.0"

执行清理重装命令：

rm -rf node_modules package-lock.json
npm cache clean --force
npm install

2. 移除冗余依赖 #

项目同时存在@awesome-cordova-plugins和@ionic-native系列包，二者是同一套Cordova插件的新旧命名空间，保留一套即可：

• 删除所有@ionic-native开头的依赖项
• 重新执行npm install

3. 验证底层Cordova插件兼容性 #

确认cordova-plugin-file（当前为7.0.0）与@awesome-cordova-plugins/file@6.3.0版本兼容，当前版本匹配无需调整。

4. 用overrides强制解决冲突（备选方案） #

若上述步骤未解决，在package.json中添加overrides字段，强制指定@awesome-cordova-plugins/file使用项目中的core版本：

"overrides": {
  "@awesome-cordova-plugins/file": {
    "@awesome-cordova-plugins/core": "6.3.0"
  }
}

再执行npm install即可。

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