UnsupportedClassVersionError是因类文件由更高JDK版本编译而运行环境版本较低导致，需确保编译与运行Java版本匹配，可通过升级JRE、统一构建配置或使用-source/-target指定兼容版本解决。
当Java程序运行时抛出UnsupportedClassVersionError，说明你尝试加载的类文件是由更高版本的JDK编译生成的，而当前运行环境（JRE）不支持该版本。这个错误发生在类加载阶段，典型错误信息如下：
java.lang.UnsupportedClassVersionError: com/example/MyClass has been compiled by a more recent version of the Java Runtime (class file version 61.0), this version of the Java Runtime only recognizes class file versions up to 55.0上面提示：类是用Java 17（版本61）编译的，但当前JRE只支持到Java 11（版本55），导致无法运行。
理解类文件版本与JDK对应关系
每个JDK版本对应一个固定的类文件主版本号。常见对应关系如下：
- Java 8 → 52
- Java 9 → 53
- Java 10 → 54
- Java 11 → 55
- Java 12 → 56
- Java 13 → 57
- Java 14 → 58
- Java 15 → 59
- Java 16 → 60
- Java 17 → 61
- Java 18 → 62
- Java 19 → 63
- Java 20 → 64
- Java 21 → 65
只要运行环境的JRE主版本低于编译时使用的JDK主版本，就可能触发此异常。
立即学习“Java免费学习笔记（深入）”；
检查并统一Java编译与运行版本
确保开发、构建和部署环境使用一致的Java版本。
查看当前Java版本：
java -version javac -version
如果两者版本不一致，或低于类文件要求的版本，就需要调整。
解决方案：
- 升级运行环境的JRE/JDK至等于或高于编译版本。例如，若类由Java 17编译，则运行环境至少为Java 17。
- 在生产服务器上部署前，确认Java版本满足应用要求。
- 使用
JAVA_HOME明确指定使用的JDK路径，避免系统调用旧版本。
通过编译选项降低目标版本兼容性
如果你必须在低版本JRE上运行，可以在编译时使用-target和-source选项指定向后兼容的版本。
例如，使用Java 17 JDK但目标运行环境是Java 11：
javac -source 11 -target 11 MyClass.java
在Maven项目中配置：
<properties> <java.version>11</java.version> <maven.compiler.source>11</maven.compiler.source> <maven.compiler.target>11</maven.compiler.target> </properties>
在Gradle中：
java {
sourceCompatibility = JavaVersion.VERSION_11
targetCompatibility = JavaVersion.VERSION_11
}
注意：即使这样编译，也不能使用高版本才有的API，否则会在运行时报错。
使用工具检测类文件版本
可以通过javap命令查看某个class文件的版本：
javap -verbose MyClass | grep "major"
输出示例：
major version: 61
对照前面的版本表即可判断是哪个JDK编译的。
也可以写一个小脚本批量检查jar包中的类版本，帮助排查第三方依赖是否包含高版本类文件。
基本上就这些。关键是搞清楚“谁编译的”和“谁在运行”，保持版本匹配就能避免这个问题。
