如何解决Java主类加载时出现LinkageError错误？是否需更换JDK运行时？

问题原因 #

这是JDK编译版本与运行版本不匹配导致的错误：

• 目标类用JDK 16编译，对应类文件版本号60.0
• 运行时实际调用的是conda自带的JDK 11，最高仅支持版本号55.0的类文件，因此抛出UnsupportedClassVersionError

出现/Users/username/opt/anaconda3/bin/java路径的原因：conda安装时会将自身的bin目录添加到系统PATH的最高优先级，覆盖了系统安装的JDK路径，IntelliJ默认继承shell的PATH配置，因此运行时优先调用了conda目录下的Java 11。

解决方案 #

方案1：直接修改IntelliJ运行配置（最快生效） #

• 点击IntelliJ右上角运行配置下拉框，选择「编辑配置」，找到ChatServerStarter对应的运行项
• 将「运行时JRE」手动指定为JDK 16.0.1，若下拉框无对应选项，点击「添加SDK」导入路径/Library/Java/JavaVirtualMachines/jdk-16.0.1.jdk/Contents/Home即可

方案2：修正Gradle全局JVM配置 #

• 打开IntelliJ偏好设置（macOS快捷键⌘+,，Windows路径为File→Settings），依次进入「构建、执行、部署」→「构建工具」→「Gradle」
• 找到对应项目的「Gradle JVM」配置项，手动选择JDK 16.0.1，不要选择「使用JAVA_HOME」或「项目SDK」，避免继承异常的环境变量

方案3：彻底修复系统PATH的Java优先级 #

如果希望全局默认使用JDK 16，修改shell配置文件：

• 编辑对应shell的配置文件（zsh为~/.zshrc，bash为~/.bash_profile），在conda初始化代码块之前添加如下配置：

export PATH="/Library/Java/JavaVirtualMachines/jdk-16.0.1.jdk/Contents/Home/bin:$PATH"

• 执行source ~/.zshrc（对应你修改的配置文件）使配置生效，之后执行java -version会返回16.0.1版本

验证配置 #

修改完成后清理IntelliJ缓存：点击「文件」→「清除缓存并重启」，重新构建项目运行即可。

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