运行npx react-native run-android报错：Android Gradle插件需Java 11

核心报错信息 #

构建失败：出现异常。

• 出错位置：构建文件 /Users/vivek/Documents/Code-Here/React-Native/instaClone/android/app/build.gradle 第1行
• 触发阶段：评估项目 :app 时发生错误

应用插件 com.android.internal.application 失败。Android Gradle插件运行需要Java 11版本支持，当前使用的是Java 1.8版本。

• 最终结果：构建过程耗时7秒后失败，抛出应用安装失败提示，底层执行命令./gradlew app:installDebug -PreactNativeDevServerPort=8081执行异常，重复运行会持续抛出相同的Java版本不匹配错误。

可用修复方案 #

• 方案一：修改系统JAVA_HOME环境变量，指向本机已安装的JDK 11路径，配置完成后终端执行java -version确认输出版本为11.x，再重新运行项目启动命令即可。
• 方案二：打开项目下的android/gradle.properties文件，新增或修改org.gradle.java.home配置项，值填写本机JDK 11的绝对路径，Mac环境示例配置：

org.gradle.java.home=/Library/Java/JavaVirtualMachines/jdk-11.0.x.jdk/Contents/Home

• 方案三：如果使用Android Studio打开项目调试，直接在IDE的Gradle设置页，将Gradle运行依赖的JDK版本切换为JDK 11即可。

进阶排查方式 #

如果按上述方案修复后仍存在构建问题，可以追加参数运行命令获取更多定位信息：

• 添加--stacktrace参数运行，获取完整错误堆栈轨迹
• 添加--info或--debug参数运行，输出更详细的构建过程日志
• 添加--scan参数运行，生成完整的构建过程分析结果

内容的提问来源于stack exchange，提问作者Vivek R K