Как исправить ошибку java.lang.UnsupportedClassVersionError: неподдерживаемая версия major.minor?

Что такое major.minor version и почему возникает ошибка?

Ошибка java.lang.UnsupportedClassVersionError возникает, когда вы пытаетесь запустить скомпилированный Java-класс с помощью более старой версии JRE (Java Runtime Environment), чем та, на которой он был скомпилирован. Каждая версия Java имеет свой номер версии class-файла:

• Java 5 (49.0)
• Java 6 (50.0)
• Java 7 (51.0)
• Java 8 (52.0)
• Java 9 (53.0)
• Java 11 (55.0)
• Java 17 (61.0)

В вашем примере major.minor version 52.0 — это версия Java 8. Ошибка означает, что вы компилируете код с помощью JDK 8 (который создаёт class-файлы версии 52.0), а запускаете его с помощью более старой JRE (например, Java 7 или 6), которая не понимает такой формат.

Как проверить версии Java на вашей системе?

Выполните в командной строке:

java -version  // версия JRE, которая запускает программы
javac -version // версия JDK, которая компилирует

Скорее всего, у вас установлено несколько версий Java, и для компиляции используется одна (JDK 8), а для запуска — другая (более старая).

Решение №1: Использовать одну и ту же версию Java

Самый простой способ — убедиться, что переменные окружения JAVA_HOME и PATH указывают на одну и ту же версию. Например, для Java 8:

set JAVA_HOME=C:\Program Files\Java\jdk1.8.0_201
set PATH=%JAVA_HOME%\bin;%PATH%

После этого перезапустите командную строку и проверьте обе версии — они должны совпадать.

Решение №2: Компилировать с указанием целевой версии

Если вам нужно запускать программу на старой JRE (например, Java 7), скомпилируйте с флагами -source и -target:

javac -source 1.7 -target 1.7 HelloWorld.java

Это создаст class-файл версии 51.0, который будет работать на Java 7 и выше. Для Java 6 используйте 1.6.

Важно: Убедитесь, что ваш код не использует возможности Java 8 (лямбды, Stream API и т.д.), иначе он не скомпилируется с -source 1.7.

Решение №3: Использовать Maven или Gradle

Если вы используете систему сборки, укажите версию компиляции в конфигурации. Пример для Maven (pom.xml):

<properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
</properties>

Для Gradle (build.gradle):

tasks.withType(JavaCompile) {
    sourceCompatibility = '1.8'
    targetCompatibility = '1.8'
}

Решение №4: Обновить JRE

Если вы не можете изменить версию компиляции, просто обновите JRE до той же версии, что и JDK. Скачайте установщик с официального сайта Oracle или используйте OpenJDK.

Как определить версию class-файла?

Используйте утилиту javap:

javap -verbose HelloWorld.class | findstr major

Вы увидите строку вроде major version: 52 — это и есть версия компиляции.

Надеюсь, это поможет! Главное — запомнить: версия компиляции должна быть ≤ версии JRE, на которой вы запускаете программу.

# Создайте файл Dockerfile
FROM openjdk:8-jre-alpine
COPY HelloWorld.java /app/
WORKDIR /app
RUN javac HelloWorld.java
CMD ["java", "HelloWorld"]

docker build -t hello-java8 .
docker run hello-java8