Ionic cordova run android报错JDK与javac版本不一致排查

问题表现 #

• 执行ionic cordova run android --device在安卓设备运行Ionic应用时，首次报错：

Requirements check failed for JDK 1.8.x! Detected version: 16.0.0
Check your ANDROID_SDK_ROOT / JAVA_HOME / PATH environment variables.

• 调整Java版本后，执行java -version返回java version "1.8.0_251"，但再次执行运行命令仍报相同错误。
• 排查发现javac -version返回javac 16，java与javac版本不匹配。
• 已在.zshrc中配置export JAVA_HOME=/usr/libexec/java_home -v 1.8``，但配置未对javac生效：
  • which java返回路径：/Library/Internet Plug-Ins/JavaAppletPlugin.plugin/Contents/Home/bin/java
  • which javac返回路径：/usr/bin/javac
• 怀疑与PATH环境变量配置有关，但无法定位具体错误点。

故障原因 #

这是macOS多JDK环境下典型的路径优先级错误+配置语法问题：

1. 当前调用的java来自浏览器Java插件自带的运行时，并非你安装的JDK 1.8可执行文件
2. javac调用的是/usr/bin下系统默认关联的JDK 16编译器，没有读取到配置的JAVA_HOME路径
3. 两处配置错误导致环境变量不生效：一是.zshrc中JAVA_HOME的命令替换反引号位置错误，二是没有将JDK 1.8的bin目录放到PATH优先级最高的位置，系统优先命中了其他路径下的Java程序。

修复步骤 #

1. 打开.zshrc文件，修正JAVA_HOME相关配置，替换为以下内容：

# 反引号需包裹整个java_home查询命令，原配置反引号位置错误导致赋值失效
export JAVA_HOME=`/usr/libexec/java_home -v 1.8`
# 将JDK1.8的bin目录放在PATH最前端，保证系统优先调用该路径下的java、javac
export PATH=$JAVA_HOME/bin:$PATH

2. 执行以下命令让配置立即生效，同时清除shell的命令路径缓存：

source ~/.zshrc
rehash

3. 校验环境是否正常：
   • 执行java -version、javac -version，确认两个命令返回的版本均为1.8.x
   • 执行which java、which javac，确认返回路径均以JDK1.8安装目录开头，格式类似/Library/Java/JavaVirtualMachines/jdk1.8.0_251.jdk/Contents/Home/bin/，不再指向浏览器插件路径或/usr/bin默认路径
4. 重新执行ionic cordova run android --device即可正常通过JDK版本校验。

如果校验时仍然命中旧路径，直接删除/Library/Internet Plug-Ins/JavaAppletPlugin.plugin目录即可。该插件是浏览器遗留的Applet运行组件，安卓开发场景完全不需要，残留只会干扰Java环境识别。

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