React Native执行npx react-native run-android启动模拟器报错求助

1. 核对环境变量配置 #

• 确认ANDROID_HOME和JAVA_HOME系统环境变量设置正确：
  • ANDROID_HOME需指向Android SDK根目录（常见路径：~/Android/Sdk或C:\Users\<用户名>\AppData\Local\Android\Sdk）
  • JAVA_HOME指向JDK 11安装路径，路径不能包含空格
• 在终端执行以下命令验证输出是否匹配预期路径：

  echo $ANDROID_HOME  # Linux/macOS
  echo %ANDROID_HOME% # Windows
  echo $JAVA_HOME
  

• 检查PATH变量是否包含以下关键路径：
  • $ANDROID_HOME/platform-tools
  • $ANDROID_HOME/tools
  • $ANDROID_HOME/tools/bin

2. 验证模拟器/设备连接状态 #

• 执行adb devices命令，确认模拟器被识别且状态为device（若显示offline或未列出则存在连接问题）
• 连接异常时的修复操作：
  • 在Android Studio的AVD Manager中删除并重新创建模拟器
  • 重启adb服务：

    adb kill-server
    adb start-server
    

3. 检查项目Gradle配置一致性 #

• 打开项目根目录android/build.gradle，确认Gradle插件版本与Android Studio安装版本匹配：

  dependencies {
      classpath("com.android.tools.build:gradle:7.4.2") // 需与你的Android Studio对应
      classpath("com.facebook.react:react-native-gradle-plugin:0.72.0") // 与项目RN版本对应
  }
  

• 打开android/gradle/wrapper/gradle-wrapper.properties，确认Gradle分发版本与插件版本兼容：

  distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip
  

4. 获取详细报错日志定位根源 #

• 执行npx react-native run-android --verbose，查看完整日志，重点关注FAILURE: Build failed with an exception后的具体错误信息（如依赖冲突、资源编译失败、权限问题等）
• 若日志提示签名错误，检查android/app/build.gradle的签名配置，调试模式可使用默认签名：

  signingConfigs {
      debug {
          storeFile file('debug.keystore')
          storePassword 'android'
          keyAlias 'androiddebugkey'
          keyPassword 'android'
      }
  }
  

5. 其他实操尝试 #

• 进入项目android目录，执行./gradlew clean（Linux/macOS）或gradlew clean（Windows）清理构建缓存，之后再执行npx react-native run-android
• 执行npx react-native info查看环境信息，确认react-native版本与本地开发环境的兼容性

内容的提问来源于stack exchange，提问作者MST intern 2