React Native构建报Build failed with an exception错误解决方法

问题核心原因 #

构建时抛出FAILURE: Build failed with an exception异常，触发点为android/app/build.gradle文件第1行，评估项目:app阶段无法应用插件com.android.internal.application，本质是当前项目所用Android Gradle插件要求运行环境为Java 11，实际构建环境调用的是Java 1.8，版本要求不匹配。

解决步骤 #

按以下优先级操作，每步完成后可重新执行安卓构建命令验证是否修复：

• 先确认当前Gradle实际调用的Java版本
  在项目根目录打开终端，Windows系统执行gradlew.bat -version，Mac/Linux系统执行./gradlew -version，查看输出内容里的JVM字段，确认当前确实为1.8版本，排除其他报错可能。
• 项目级固定Java版本（最推荐，不影响其他项目环境）
  打开项目下的android/gradle.properties文件，新增或修改org.gradle.java.home配置项，直接填写本机Java 11的安装绝对路径：
  Windows配置示例：

  org.gradle.java.home=C:\\Program Files\\Java\\jdk-11.0.18
  

  Mac配置示例：

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

  配置保存后直接重新构建即可，该配置仅对当前项目生效，不会改动全局环境。
• 修改全局JAVA_HOME环境变量（适合本地所有安卓项目都需要Java 11环境的场景）
  1. Windows：打开系统环境变量面板，找到JAVA_HOME变量，将值修改为Java 11的安装根目录，同时检查Path变量，确保%JAVA_HOME%\bin的优先级高于其他Java版本的bin路径，修改完成后重启终端生效。
  2. Mac/Linux：编辑当前使用的shell配置文件（如.zshrc、.bashrc），修改JAVA_HOME的导出路径为Java 11安装路径，执行source 对应配置文件让配置立即生效。
     配置完成后重新执行java -version、gradlew -version，确认输出Java版本为11即可。
• 调整Android Studio配置（仅用IDE构建/运行时需要配置）
  打开Android Studio设置页，依次进入Build, Execution, Deployment > Build Tools > Gradle，将Gradle JDK选项下拉选择为本地安装的Java 11版本，保存后等待项目同步完成即可。

注意：如果本地没有安装Java 11，需要先下载JDK 11长期支持版本完成安装，再执行上述配置操作，不要使用Java 8、Java 17+等非兼容版本，避免触发其他版本适配问题。

内容的提问来源于stack exchange，提问作者Ertuğrul Özer