升级Capacitor 5后执行ionic cap add android出现依赖冲突错误

已将Capacitor相关依赖升级至5版本，package.json中的依赖如下：

"@capacitor/android": "^5.0.4",
"@capacitor/app": "^5.0.2",
"@capacitor/core": "^5.0.3",
"@capacitor/haptics": "^5.0.2",
"@capacitor/ios": "^5.0.4",
"@capacitor/keyboard": "^5.0.2",
"@capacitor/status-bar": "^5.0.2",

但执行ionic cap add android时，系统却尝试安装旧版本@capacitor/android@4.1.0，触发ERESOLVE依赖树冲突：

npm.cmd i -E @capacitor/android@4.1.0
npm ERR! code ERESOLVE
npm ERR! ERESOLVE unable to resolve dependency tree
npm ERR! 
npm ERR! While resolving: sukssas@0.0.1
npm ERR! Found: @capacitor/core@5.0.4
npm ERR! node_modules/@capacitor/core
npm ERR!   @capacitor/core@"^5.0.3" from the root project
npm ERR! 
npm ERR! Could not resolve dependency:
npm ERR! peer @capacitor/core@"^4.0.0" from @capacitor/android@4.1.0
npm ERR! node_modules/@capacitor/android
npm ERR!   @capacitor/android@"4.1.0" from the root project
npm ERR! 
npm ERR! Fix the upstream dependency conflict, or retry

npm.cmd i -E @capacitor/android@4.1.0 exited with exit code 1.

Re-running this command with the --verbose flag may provide more information.

已尝试删除node_modules并执行npm install，问题仍未解决。

解决方法 #

1. 更新全局CLI版本 #

旧版本的Ionic/Capacitor CLI可能不兼容Capacitor 5，导致拉取旧版依赖：

• 更新Capacitor CLI：

  npm install -g @capacitor/cli@latest
  

• 更新Ionic CLI：

  npm install -g @ionic/cli@latest
  

2. 清除npm缓存 #

缓存的旧版本信息可能干扰依赖拉取：

npm cache clean --force

3. 手动指定版本添加平台 #

跳过Ionic CLI的自动检测，直接用Capacitor CLI指定5.x版本添加：

npx cap add android@5.0.4

4. 重置锁文件与依赖 #

锁文件可能残留旧版本引用，执行以下步骤重置：

• 删除package-lock.json（或yarn.lock）
• 删除node_modules文件夹
• 重新安装依赖：

  npm install
  

5. 检查第三方插件兼容性 #

部分第三方插件可能未适配Capacitor 5，强制拉取4.x版本依赖。用以下命令排查依赖树：

npm ls @capacitor/core

查看输出中是否有其他依赖要求@capacitor/core@^4.0.0，如有则升级对应插件版本或替换为兼容Capacitor 5的插件。

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