UnsupportedClassVersionError

UnsupportedClassVersionError (지원되지 않는 클래스 버전 오류)

Java 가상 머신이 클래스 파일을 읽으려 할 때 파일에 있는 major/minor 버전 번호를 지원하지 않는 경우 던져지는 오류입니다. ClassFormatError의 하위 클래스입니다.

출처: Java API Reference

이 오류는 보통 더 높은 Java 버전으로 컴파일된 클래스 파일을 낮은 버전의 JVM에서 실행하려 할 때 발생합니다. 예를 들어 Java 21로 컴파일된 클래스를 Java 17 런타임에서 로드하면 이 오류가 발생할 수 있습니다.

해결 방법으로는 더 높은 버전의 JVM을 사용하거나, --release 옵션으로 대상 버전을 맞춰 다시 컴파일하는 방법이 있습니다.

해당 파일의 major, minor 버전이 현재 JVM이 지원하는 범위를 벗어날 때 발생합니다.

.class 파일을 컴파일한 JDK 버전과 실행하는 JRE 버전의 차이를 확인합니다.

java -version으로 런타임 버전을 확인하고, 필요한 경우 대상 버전으로 다시 컴파일합니다.