执行ionic capacitor build android时出现依赖树解析失败错误

错误详情 #

执行命令：

PS C:\Users\User\source\repos\imango\src> ionic capacitor build android

触发的npm错误：

npm.cmd i -E @capacitor/android@latest
npm ERR! code ERESOLVE
npm ERR! ERESOLVE 无法解析依赖树
npm ERR!
npm ERR! 解析时：mango@0.0.1
npm ERR! 已找到：@capacitor/core@3.7.0
npm ERR! node_modules/@capacitor/core
npm ERR! 根项目中的@capacitor/core@"^3.5.1"
npm ERR!
npm ERR! 无法解析依赖项：
npm ERR! @capacitor/android@4.0.1需要对等依赖@capacitor/core@"^4.0.0"
npm ERR! node_modules/@capacitor/android
npm ERR! 根项目中的@capacitor/android@"4.0.1"
npm ERR!
npm ERR! 请修复上游依赖冲突，或使用--force或--legacy-peer-deps参数重试命令
npm ERR! 以接受不正确（且可能失效）的依赖解析结果。
npm ERR!
npm ERR! 完整报告请查看：C:\Users\User\AppData\Local\npm-cache\eresolve-report.txt

最终错误提示：

npm ERR! 本次运行的完整日志可在以下位置找到：
npm ERR!     C:\Users\User\AppData\Local\npm-cache_logs\2022-08-06T22_53_19_523Z-debug-0.log
[ERROR] 运行子进程npm时发生错误。
    npm.cmd i -E @capacitor/android@latest 退出码为1。

    使用--verbose参数重新运行此命令可能会提供更多信息。

问题原因 #

项目中当前安装的@capacitor/core版本为3.7.0，但命令尝试安装的最新版@capacitor/android（4.0.1）要求@capacitor/core版本必须是^4.0.0，两者版本不兼容，导致npm无法完成依赖树解析。

解决方案 #

方案1：升级Core到匹配版本（推荐） #

将@capacitor/core和@capacitor/android统一升级到最新版，确保版本完全兼容：

npm install @capacitor/core@latest @capacitor/android@latest

升级完成后同步Capacitor配置到Android项目：

npx cap sync android

注意：如果项目中还使用了其他Capacitor插件（如@capacitor/camera、@capacitor/storage等），也需要将它们升级到4.x版本，避免出现新的依赖冲突。

方案2：降级Android插件到Core匹配版本 #

如果不想升级Core版本，可以安装与3.7.0兼容的Android插件版本：

npm uninstall @capacitor/android
npm install @capacitor/android@3.7.0

同步配置：

npx cap sync android

方案3：强制安装（不推荐） #

使用npm的--legacy-peer-deps参数跳过依赖检查强制安装，但这种方式可能导致运行时异常，仅作为临时测试使用：

npm install -E @capacitor/android@latest --legacy-peer-deps

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