Mac上JAVA_HOME与java -version显示Java版本不一致如何排查

JAVA_HOME配置值和java -version返回结果不一致，完全是无效环境变量残留+命令查找优先级导致的，不存在系统异常：

• 你最初看到的/usr/lib/jvm/java-1.8.0-openjdk-amd64是Linux发行版的标准JDK安装路径，Mac系统默认不会生成这个路径，也不会把JDK装到这个位置。这个值是之前配置环境时复制了Linux下的配置片段，写入shell配置文件的无效残留，本地根本不存在对应目录，自然不会生效。
• java -version返回的OpenJDK 17.0.1是你系统里实际可调用的有效Java版本。shell执行命令时会按照PATH环境变量的顺序查找可执行文件，之前写的假JAVA_HOME没有被正确加入PATH优先级最高的位置，所以实际调用的是你手动安装的Java17，这也是IDEA一直能正常运行项目的原因——IDEA不会直接读取shell里配置的JAVA_HOME，会主动扫描系统内所有有效JDK路径。
• 后续JAVA_HOME自动修正为Java17路径，是IDEA初始化配置或者Mac自带的Java环境管理工具自动清理了无效配置值，属于正常现象。

直接在终端执行Mac自带的Java版本查询命令，会列出所有系统识别到的有效JDK，附带对应版本号和安装路径：

/usr/libexec/java_home -V

注意参数是大写的V，输出列表里没有的JDK路径，全是无效残留配置，不需要处理。
Mac下所有正常安装的JDK都会存放在/Library/Java/JavaVirtualMachines/目录下，你可以直接进这个目录核对已安装版本。

你当前设备上并没有实际安装Java 8，之前的无效路径不算可用环境，按以下步骤操作即可：

• 安装Java 8：选择OpenJDK 8或者Oracle官方JDK 8安装包完成安装，装完重新执行上面的/usr/libexec/java_home -V，确认列表里出现1.8版本的条目。
• 临时切换（仅当前终端窗口生效）：执行以下命令即可将当前窗口的Java环境切到8版本：

  export JAVA_HOME=`/usr/libexec/java_home -v 1.8`
  

  执行完可以分别跑echo $JAVA_HOME和java -version验证，二者会统一指向Java 8。
• 永久切换（所有新开终端默认使用Java 8）：
  • 如果你用Mac默认的Zsh终端，打开~/.zshrc文件，把上面的export命令追加到文件末尾，保存后执行source ~/.zshrc让配置立即生效。
  • 如果你用Bash终端，把命令追加到~/.bash_profile文件末尾，执行source ~/.bash_profile生效即可。
• IDEA不需要额外做全局配置，打开项目后在项目SDK设置里选择对应版本的JDK就行，不会和终端配置冲突。

如果后续需要频繁在Java 8、Java 17之间切换，可以在shell配置文件里加两个别名快速切换，不用每次手动修改配置。

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