排查jdk问题需分层验证：先确认安装路径无空格/中文、含bin/java.exe/javac.exe且权限正常；再检查java_home与path是否生效，确保where java首项匹配%java_home%\bin；接着验证java -version与javac -version完全一致；最后检查ide是否独立配置了jdk路径。

排查 JDK 安装与环境变量配置问题，关键不是反复重装，而是分层验证、逐点定位。多数“报错不明确、命令能用但项目跑不了”的情况，根源都在路径指向混乱或版本错配。下面按真实排查逻辑展开，不讲概念，只说你能立刻执行的步骤。

确认 JDK 是否真装对了位置

很多人以为“安装完成=可用”，其实安装向导可能默认把 JDK 装进带空格或中文路径里（比如 C:\Program Files\Java\jdk-17.0.1），而某些工具或脚本会因空格解析失败。更隐蔽的是：Windows 下部分安装包会额外创建一个 jre 子目录，但新版 JDK 已不再内置独立 jre 文件夹——如果你看到 C:\...\jdk-17\jre，大概率是旧版残留或误装。

• 打开文件资源管理器，手动导航到你认为的 JDK 安装目录，检查是否存在 bin 文件夹，且里面包含 java.exe 和 javac.exe
• 右键点击该目录 → 属性 → “安全”选项卡 → 确认当前用户有读取+执行权限（尤其在非管理员账户下安装时容易被限制）
• 避免使用 OneDrive 同步文件夹、桌面、文档等系统重定向路径作为 JDK 安装地，这些位置可能触发访问控制异常

验证 JAVA_HOME 和 PATH 是否真正生效

配完环境变量后，别急着关窗口——系统不会自动刷新所有终端。你在 IDE 或新打开的命令行里执行的命令，可能仍沿用旧缓存。

Java Maven Common

Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。

下载

• 新开一个命令提示符（CMD）或 PowerShell，输入：echo %JAVA_HOME%（Windows）或 echo $JAVA_HOME（macOS/Linux），看输出是否为你设置的完整路径（不含末尾斜杠）
• 再输入：where java（Windows）或 which java（macOS/Linux），它会列出所有可执行的 java 位置；第一个结果必须和 %JAVA_HOME%\bin（或 $JAVA_HOME/bin）完全一致
• 如果 where java 返回多个路径，说明 PATH 中有其他 Java 目录排在前面，删掉或调整顺序（把 %JAVA_HOME%\bin 移到 PATH 最前面）

区分 java 和 javac 的版本是否一致

出现“javac 不是内部或外部命令”或“UnsupportedClassVersionError”，往往不是没装 JDK，而是 java 和 javac 来自不同版本——比如系统 PATH 里混进了旧版 JRE 的 bin，导致 java 指向 JRE，而 javac 根本找不到。

• 分别运行：java -version 和 javac -version，两个输出的版本号必须完全相同（包括构建号，如 17.0.1+12-LTS）
• 若 javac 报错，但 java 正常，说明 PATH 没包含 JDK 的 bin，只包含了某个 JRE 的 bin
• 若两者版本不一致，说明你机器上存在多个 JDK/JRE，且环境变量或系统软链接指向了不同来源

检查 IDE 是否绕过了系统环境变量

IntelliJ IDEA、Eclipse、VS Code 的 Java 插件通常不读取系统 PATH，而是依赖自己配置的 JDK 路径。所以即使命令行一切正常，IDE 仍可能报“No JDK configured”或编译失败。

• 在 IDEA 中：File → Project Structure → Project → Project SDK，确认下拉列表里选中的路径和你设置的 JAVA_HOME 一致
• 同时检查 Modules → Sources → Language level，确保它不高于所选 JDK 支持的版本（例如 JDK 17 项目不能设为 “21”）
• VS Code 用户需确认 java.home 设置项是否指向正确路径（在 settings.json 中），而非依赖自动探测

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南