在 Windows 环境下开发时，经常需要同时使用多个 JDK 版本（比如老项目依赖 JDK 1.8，新项目采用 JDK 21）。配置多版本 JDK 的核心思路是通过切换 JAVA_HOME 实现版本切换，但实际操作中很容易出现'修改了 JAVA_HOME 路径，执行 java -version 仍显示旧版本'的问题。本文结合实际排查案例，详细拆解问题原因、解决方案和通用避坑技巧，帮助快速搞定多版本 JDK 配置。
一、背景：多版本 JDK 配置后切换失效
将 JDK 1.8 和 JDK 21 分别安装在两个独立目录，计划通过修改 JAVA_HOME 的路径实现版本切换。但在将 JAVA_HOME 切回 JDK 1.8 目录后，执行 java -version 命令，输出结果依旧是 JDK 21，版本切换未生效。下面一步步拆解问题。
二、核心排查工具：定位问题根源的关键命令
遇到 Java 版本不匹配问题时，首先要搞清楚：系统当前执行的 java.exe 到底来自哪个目录？这里推荐使用 Windows 自带的 where 命令，它能列出系统中所有可找到的目标程序路径，且按查找优先级排序（第一个路径就是当前实际调用的路径）。
执行命令：
where java
排查输出结果（本文案例实际输出）：
C:\Program Files\Common Files\Oracle\Java\javapath\java.exe D:\soft\JDK\JDK18\bin\java.exe
从输出可以明确问题根源：系统优先调用了 C:\Program Files\Common Files\Oracle\Java\javapath\java.exe（该路径是 Oracle JDK 安装时自动注册的高优先级路径，关联的是 JDK 21），而非手动配置的 JDK 1.8 路径。这就是修改 JAVA_HOME 后版本仍不生效的核心原因。
三、问题原因深度解析（常见场景汇总）
结合排查经验和日常案例，Windows 多版本 JDK 切换失效的原因主要有以下 4 类，按出现概率排序：
1. 高优先级的自动注册路径干扰（本文案例核心原因）
Oracle JDK 的.exe 安装包默认会勾选'自动添加到系统 Path'，并在系统 Path 中注册 C:\Program Files\Common Files\Oracle\Java\javapath 路径。该路径的优先级极高，会覆盖手动配置的 %JAVA_HOME%\bin，导致即使修改了 JAVA_HOME，系统仍优先调用自动注册路径下的 Java 版本。
2. 旧终端窗口未重启，环境变量未刷新
Windows 终端（CMD/PowerShell）在打开时会一次性加载当前的环境变量配置。修改环境变量后，已打开的旧终端不会自动更新配置，仍沿用打开时的旧环境变量。很多同学忽略了这一点，导致修改后验证失败。
3. Path 环境变量中存在旧版本硬编码路径
若之前直接在 Path 中添加过具体 JDK 版本的硬编码路径（比如 D:\soft\JDK\JDK21\bin），且该路径优先级高于 %JAVA_HOME%\bin，系统会优先调用硬编码路径对应的 Java 版本，修改 JAVA_HOME 也无法生效。
4. 环境变量冲突（用户变量与系统变量重复）
若在'用户变量'和'系统变量'中都配置了 JAVA_HOME，且两者指向不同版本，可能出现'修改了其中一个，另一个仍生效'的情况（系统变量优先级通常高于用户变量，具体取决于配置顺序）。此外，若配置了 JRE_HOME 且指向旧版本，也可能导致冲突。
四、针对性解决方案（分步操作，快速生效）
结合排查结果，按'先解决核心问题，再优化配置'的思路分步操作，确保版本切换正常。
步骤 1：删除高优先级的自动注册路径（核心操作）
- 打开环境变量配置窗口：右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。
- 重点检查「系统变量」中的 Path 变量（自动注册路径通常在系统 Path 中），双击 Path 进入编辑界面。
- 找到
C:\Program Files\Common Files\Oracle\Java\javapath路径，选中后点击「删除」（无需保留，删除后不影响手动配置的 JDK 使用）。
