执行npm start -> npm run android时React Native应用无法安装

问题场景 #

执行npm start后运行npm run android，应用无法完成安装，相关日志如下：

info 正在Android上打开应用...
info JS服务器已在运行。
info 正在启动模拟器...
info 模拟器启动成功。
info 正在安装应用...
info 💡 提示：请确保已通过运行react-native doctor正确配置开发环境。
info 使用--verbose标志运行CLI以获取更多详细信息。
应用未安装

排查与解决步骤 #

• 运行npx react-native doctor检查开发环境，修复所有检测出的配置问题（如Android SDK、NDK、模拟器依赖等）。
• 执行npm run android --verbose获取详细安装日志，定位具体报错原因（比如签名异常、模拟器权限不足、依赖版本冲突等）。
• 清理项目缓存：
  • 进入Android目录执行./gradlew clean清理构建缓存
  • 回到项目根目录执行npm cache clean --force清理npm缓存
• 检查模拟器状态：
  • 确认模拟器已正常加载系统界面，无卡顿或启动失败情况
  • 尝试重启模拟器，或更换不同API等级的Android镜像测试
• 验证adb连接：运行adb devices确认模拟器已被识别，若未识别则执行adb kill-server && adb start-server重启adb服务
• 检查Android项目配置：
  • 确认android/build.gradle和android/app/build.gradle中的SDK版本与本地安装的SDK版本匹配
  • 检查debug签名配置，确保签名文件存在且配置参数正确

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