Big Sur系统下Ionic Capacitor运行Android构建报JavaHome错误如何解决？

排查解决步骤 #

错误核心原因是Gradle读取到的javaHome为无效的系统默认插件路径，你配置的正确JAVA_HOME未被正确加载，按以下步骤排查即可：

• 第一步：验证当前终端环境变量是否生效
  执行命令 echo $JAVA_HOME，确认输出是否为你配置的 /Library/Java/JavaVirtualMachines/temurin-11.jdk/Contents/Home
  如果输出不符合，执行 source ~/.zshrc 重新加载配置后再次验证。如果还是输出错误路径，执行 ls /Library/Java/JavaVirtualMachines/temurin-11.jdk/Contents/Home 确认该路径真实存在，不存在的话重新安装对应版本JDK即可。
• 第二步：验证终端加载配置后是否能正常运行
  确认echo $JAVA_HOME输出正确后，在同一终端窗口执行 ionic capacitor run android 看是否还报错。
• 第三步：检查项目Gradle配置是否有硬编码的java路径
  打开项目android/gradle.properties文件，检查是否存在org.gradle.java.home配置项：
  如果存在，直接删除该配置项，让Gradle自动读取系统环境变量的JAVA_HOME；也可以直接修改为你正确的JDK路径。
• 第四步：修复macOS系统默认JDK优先级
  执行 /usr/libexec/java_home -V 查看系统识别的所有JDK版本，如果默认版本指向错误的Applet插件路径，可将~/.zshrc中的JAVA_HOME配置替换为export JAVA_HOME=$(/usr/libexec/java_home -v 11)，自动匹配本地安装的JDK11版本，避免硬编码路径出错，修改后执行source ~/.zshrc生效。
• 第五步：重启IDE验证
  如果你是在IDE自带的终端中执行命令，IDE启动时会缓存环境变量，修改配置后重启IDE即可读取到新的环境变量。
• 第六步：临时验证方案
  可直接在执行命令时指定JAVA_HOME：JAVA_HOME=/Library/Java/JavaVirtualMachines/temurin-11.jdk/Contents/Home ionic capacitor run android，如果该命令可正常运行，即可确认问题根源是环境变量未正确加载，按以上步骤修复即可。

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