React Native执行npx react-native run-android时应用安装失败求助

问题概况 #

执行npx react-native run-android后模拟器正常启动，但应用始终无法完成安装。已完成JS服务器启动、SDK及虚拟设备配置等所有指南要求操作，仍未解决问题。

排查与解决步骤 #

• 确认adb连接有效性
  终端执行adb devices，检查模拟器设备状态是否为device。若显示offline，重启模拟器并确保已开启USB调试（模拟器路径：设置→系统→开发者选项→USB调试），重新执行命令。

• 清理项目缓存后重构
  依次执行以下命令：

  cd 你的项目根目录
  ./gradlew clean
  npx react-native clean
  npm install
  

  完成后再次运行npx react-native run-android。

• 检查模拟器存储空间
  模拟器磁盘不足会导致安装失败。进入模拟器设置→存储查看剩余空间，若不足则清理无用文件，或创建新虚拟设备时分配更大存储容量。

• 核对SDK版本兼容性
  打开项目android/build.gradle文件，确认compileSdkVersion、targetSdkVersion与本地Android Studio SDK Manager中已安装的SDK版本一致，调整后重新构建。

• 手动安装APK排查错误
  先构建调试版APK：

  cd android
  ./gradlew assembleDebug
  

  找到生成的APK（路径：android/app/build/outputs/apk/debug/app-debug.apk），执行命令手动安装：

  adb install android/app/build/outputs/apk/debug/app-debug.apk
  

  根据安装时的具体错误提示定位问题。

• 临时关闭代理/防火墙
  若本地开启代理或防火墙，可能阻断adb与模拟器的通信，暂时关闭后重试安装。

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