本文介绍如何通过 `java`、`javac` 和 `javap` 命令提前获取目标 jdk 所生成的 class 文件主次版本号（如 major version 61 对应 java 17），避免运行时出现 `unsupportedclassversionerror`。无需编译任何 `.class` 文件，纯命令行即可完成验证。
Java 类文件的兼容性由其 major/minor version 决定，该版本号在编译时由 javac 固定写入字节码，并被 JVM 在加载时校验。若运行时 JVM 的支持版本低于 class 文件版本（例如用 Java 11 运行 Java 17 编译的类），便会抛出经典的 java.lang.UnsupportedClassVersionError。因此，在构建或部署前确认工具链的字节码目标版本至关重要。
幸运的是，JDK 自带的 java、javac 和 javap 均可通过内置 JVM 参数 -XshowSettings:properties 输出其内部使用的 java.class.version 属性——该值直接对应其默认生成或期望加载的 class 版本（格式为 major.minor，如 61.0 表示 major=61, minor=0）。
✅ 推荐检查方式（逐个执行）：
# 查看当前 java 运行时支持的 class 版本（即它能加载的最高版本） java -XshowSettings:properties -version 2>&1 | grep 'java\.class\.version' # 查看当前 javac 编译器默认生成的 class 版本（即它产出的字节码版本） javac -J-XshowSettings:properties -version 2>&1 | grep 'java\.class\.version' # javap 同理（通常与 javac 一致，因共享同一 JDK 环境） javap -J-XshowSettings:properties -version 2>&1 | grep 'java\.class\.version'
? 更高效的一键比对脚本：
立即学习“Java免费学习笔记（深入）”；
for cmd in "java " "javac -J" "javap -J"; do \
echo "== ${cmd% *} =="; \
${cmd}-XshowSettings:properties -version 2>&1 | grep -E 'java\.class\.version'; \
done典型输出示例：
== java ==
java.class.version = 61.0 # → Java 17 运行时（支持至 major 61）
== javac ==
java.class.version = 55.0 # → Java 11 编译器（默认生成 major 55）
== javap ==
java.class.version = 55.0⚠️ 关键注意事项：
- java.class.version 是 JVM 实现的属性，不是用户可配置的编译选项；它反映该 JVM 默认支持/生成的版本基准。
- javac 的实际输出版本可通过 -source 和 -target（或现代 -release）参数显式指定，但上述命令显示的是其默认行为（无额外参数时的版本）。
- 若 java 与 javac 显示不同 java.class.version（如上例中 61 vs 55），说明系统存在 JDK/JRE 混装（例如 java 来自 JDK 17，javac 来自 JDK 11）。这极易引发兼容性问题，应统一环境：Linux 下可用 sudo update-alternatives --config java 和 --config javac 调整；macOS 可通过 JAVA_HOME 精确控制；Windows 建议检查 PATH 顺序及 JAVA_HOME 设置。
- java -version 仅显示 JRE/JDK 发布版本号（如 "17.0.8.1"），不体现字节码规范版本；而 java.class.version = 61.0 才是真正决定类加载兼容性的核心指标。
? 小结：
始终优先使用 javac -J-XshowSettings:properties -version 获取编译器默认输出版本，再用 java -XshowSettings:properties -version 确认目标运行环境是否兼容。二者 java.class.version 值应满足：javac 的 version ≤ java 的 version，否则必报 UnsupportedClassVersionError。将此检查纳入 CI/CD 或本地构建前验证脚本，可有效规避生产环境的类版本冲突风险。
