在Java开发过程中,新版本JDK可能引入破坏性变更、依赖库不兼容或者生产环境仍使用旧版本JDK需要本地对齐环境,这时候就需要将当前使用的JDK回退到指定的旧版本。不同操作系统的回滚操作存在差异,同时也可以通过多版本管理工具简化切换流程,以下是完整的操作方案。

Windows系统回退JDK步骤
1. 卸载当前新版本JDK
打开控制面板中的程序和功能,找到当前安装的高版本JDK,右键选择卸载,按照提示完成卸载流程。如果之前安装过多个JDK版本,可以保留需要回退到的旧版本,仅卸载不需要的高版本即可。
2. 安装目标旧版本JDK
如果没有保留旧版本JDK安装包,需要下载对应版本的JDK安装程序,运行安装流程,选择自定义安装路径,建议安装在无中文、无空格的目录下,比如D:Javajdk1.8.0_301。
3. 配置环境变量
右键此电脑选择属性,进入高级系统设置,点击环境变量。首先修改JAVA_HOME变量,将其值设置为旧版本JDK的安装根目录:
JAVA_HOME=D:Javajdk1.8.0_301
然后修改Path变量,将原来的%JAVA_HOME%bin相关配置保留,如果之前有单独添加的新版本JDK路径,需要替换为旧版本路径。如果Path中存在C:Program FilesCommon FilesOracleJavajavapath这类自动添加的JDK路径,需要将其上移或者删除,避免优先调用新版本JDK。
4. 验证版本
打开命令提示符,执行以下命令查看当前JDK版本:
java -version
如果输出的版本号和目标旧版本一致,说明回滚成功。
macOS系统回退JDK步骤
1. 查看已安装的JDK版本
打开终端,执行以下命令列出所有已安装的JDK:
/usr/libexec/java_home -V
命令会输出所有JDK的安装路径和版本信息,找到需要回退到的旧版本对应的路径。
2. 临时切换版本(仅当前终端生效)
如果需要临时切换到旧版本,执行以下命令,将路径替换为实际旧版本JDK的路径:
export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_301.jdk/Contents/Home export PATH=$JAVA_HOME/bin:$PATH
3. 永久切换版本
如果需要永久生效,编辑shell配置文件,比如使用zsh的话编辑~/.zshrc,bash的话编辑~/.bash_profile,添加以下内容:
# 设置JDK1.8为默认版本 export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_301.jdk/Contents/Home export PATH=$JAVA_HOME/bin:$PATH
保存后执行source ~/.zshrc或者source ~/.bash_profile使配置生效,之后验证版本即可。
Linux系统回退JDK步骤
1. 卸载现有高版本JDK
如果是通过包管理器安装的JDK,执行对应的卸载命令,比如Ubuntu/Debian系统:
sudo apt-get remove openjdk-17-jdk
如果是手动安装的JDK,直接删除对应的安装目录即可。
2. 安装目标旧版本JDK
手动安装的话,将旧版本JDK压缩包解压到/usr/lib/jvm/目录下,比如解压后得到/usr/lib/jvm/jdk1.8.0_301。
3. 配置环境变量
编辑/etc/profile或者用户目录下的~/.bashrc文件,添加以下内容:
export JAVA_HOME=/usr/lib/jvm/jdk1.8.0_301 export PATH=$JAVA_HOME/bin:$PATH export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
保存后执行source /etc/profile或者source ~/.bashrc使配置生效,之后验证版本即可。
使用多版本管理工具简化切换
如果经常需要切换JDK版本,可以使用专门的版本管理工具,避免频繁修改环境变量的麻烦。
SDKMAN(适用于macOS和Linux)
SDKMAN是常用的多SDK管理工具,支持JDK版本的安装和切换,首先安装SDKMAN:
curl -s "https://get.sdkman.io" | bash
安装完成后,列出所有可用的JDK版本:
sdk list java
安装需要的旧版本JDK,比如安装JDK8:
sdk install java 8.0.302-zulu
切换到指定版本:
sdk use java 8.0.302-zulu
设置为默认版本:
sdk default java 8.0.302-zulu
jabba(跨平台)
jabba是跨平台的Java版本管理工具,Windows、macOS、Linux都可以使用,安装后可以通过命令快速安装和切换JDK版本,操作逻辑和SDKMAN类似。
回滚后注意事项
- 验证
javac版本和java版本是否一致,避免出现版本不匹配的问题:javac -version
- 检查项目中配置的JDK版本,如果是Maven项目,确认
pom.xml中的maven-compiler-plugin配置的源版本和目标版本和回滚后的JDK版本匹配:<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.8.1</version> <configuration> <source>1.8</source> <target>1.8</target> </configuration> </plugin> - 如果使用了IDE开发,需要在IDE中重新配置JDK路径,比如IntelliJ IDEA中需要在Project Structure里将Project SDK和Module SDK都切换为回滚后的旧版本JDK。