Java类文件版本号是编译器写入.class文件头部的整数，标识编译所用JDK版本，JVM运行时严格校验该值，不匹配则抛UnsupportedClassVersionError；可用javap -verbose查看major version，Maven/Gradle需显式配置或java.toolchain.version确保字节码兼容目标环境。
Java类文件版本号到底是什么
它就是编译器写进 .class 文件头部的一个整数，告诉 JVM：“这个类是用哪个 JDK 版本编译出来的”。JVM 运行时会检查这个值，如果它比当前 JVM 支持的最高版本还高，就直接抛 UnsupportedClassVersionError —— 不是警告，是硬性拒绝加载。
比如你用 JDK 21 编译了一个类，却在 JDK 17 的环境里运行，就会看到类似这样的错误：
java.lang.UnsupportedClassVersionError: com/example/App has been compiled by a more recent version of the Java Runtime (class file version 65.0), this version of the Java Runtime only recognizes class file version up to 61.0
这里的 65.0 就是 JDK 21 对应的主版本号（JDK 21 → 65），61.0 是 JDK 17 支持的最高版本（JDK 17 → 61）。
怎么查自己代码的 class 文件版本号
不用反编译，用 javap 就能看。假设你有一个 App.class：
立即学习“Java免费学习笔记（深入）”；
javap -verbose App.class | grep "major"
输出类似：major version: 65。这个数字就是关键判断依据。
-
major version 61→ JDK 17 -
major version 65→ JDK 21 -
major version 52→ JDK 8（别再默认它是“通用版本”了）
注意：javap 必须和目标运行环境的 JDK 版本一致才能正常读取——如果你用 JDK 8 的 javap 去看 JDK 21 编译的类，可能直接报错或显示不全。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
Maven/Gradle 编译时怎么控制 class 版本号
编译工具不会自动降级。你用什么 JDK 编译，默认就生成对应版本的 class 文件。要让输出兼容老 JVM，必须显式指定目标字节码版本。
Maven 用户重点看 maven-compiler-plugin 的两个配置项：
-
<source></source>：只影响语法检查（比如是否允许var、文本块） -
<target></target>或<release></release>：才真正决定生成的 class 文件版本号
推荐用 <release></release>，它更严格，会同时约束语法、API 和字节码：
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.11.0</version>
<configuration>
<release>17</release>
</configuration>
</plugin>
Gradle 用户则设 java.toolchain.version = 17，并确保没在 compileJava.options.release 之外另设 --source 或 --target，否则可能冲突。
IDE 自动编译也得盯住 JDK 版本
IntelliJ 或 Eclipse 默认用项目 SDK 编译，但「Project SDK」和「Project bytecode version」是两回事。常见坑：
- SDK 设成 JDK 21，但 Project bytecode version 没改，还是 17 → 实际仍生成 v65 类文件
- Maven 导入后覆盖了 IDE 设置，导致 IDE 编译结果和命令行不一致
- 用了 Lombok 或 MapStruct 等注解处理器，它们可能悄悄调用不同 JDK 的编译器
验证方式最简单：清空 target/ 或 build/，用命令行 mvn compile 再查一次 javap 输出。别信 IDE 左下角那个小图标。
class 文件版本不是“越新越好”，它是部署环境的硬性门槛。一个 major version 不匹配，整个应用起不来，连日志都打不出来。
