每次创建React Native新项目后运行Android端均遇报错求助

• 检查Android开发环境配置

  • 确认ANDROID_HOME环境变量已正确指向Android SDK目录
  • 确认JAVA_HOME指向JDK 11（React Native当前要求该版本，高版本易出现兼容问题）
  • 通过Android Studio的SDK Manager，确认已安装对应版本的Build Tools、Platform Tools及项目所需的Android API版本

• 清理项目缓存与构建文件

  1. 进入项目的android目录执行清理命令：

     cd android && ./gradlew clean
     

  2. 返回根目录，重新安装依赖：

     cd .. && rm -rf node_modules package-lock.json && npm install
     

• 验证设备连接状态

  • 确保模拟器正常启动，或真机已开启USB调试并成功连接（执行adb devices可查看已连接设备）
  • 优先使用Android Studio自带模拟器，避免第三方模拟器的兼容性问题

• 调整React Native版本

  • 若最新版存在兼容问题，可指定稳定版本初始化项目：

    npx react-native@0.72.6 init AwesomeProject
    

  • 具体稳定版本可参考React Native官方文档

• 优化gradle配置

  • 打开android/gradle/wrapper/gradle-wrapper.properties，确认gradle版本与React Native版本匹配（如0.72版本对应gradle 7.5）
  • 若网络不佳，可在android/build.gradle中替换国内镜像源：

    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/repository/public' }
    }
    

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