Сборка проектов LinuxWindowsmacOS

Gradle: JAVA_HOME is not set / Unsupported class file major version

  • Обновлено
  • Чтение ≈ 2 минуты

Краткий ответ

Gradle требует совместимую версию JDK. Установите JDK, задайте JAVA_HOME и подберите версию Gradle.

В этой статье
  1. Что означает ошибка
  2. Причины и признаки
  3. Пошаговое решение
  4. Если проблема осталась

#Что означает ошибка

Сообщение
JAVA_HOME is not set

Gradle требует совместимую версию JDK. Установите JDK, задайте JAVA_HOME и подберите версию Gradle.

#Причины и признаки

Возможная причинаКак узнатьЧто делать
JAVA_HOME не заданJAVA_HOME пуст или указывает на папку bin.Установите путь на корень JDK.
Несовместимый JDKВерсия class file выше поддерживаемой JVM.Сверьте JDK с совместимостью Gradle.
Старый GradleGradle wrapper не поддерживает выбранную Java.Обновляйте wrapper только согласованно с проектом.
КэшПроект использует устаревшие файлы сборки.Проверьте версию wrapper прежде очистки кэша.

#Пошаговое решение

  1. Разделите две разные ошибкиВ терминале корня проекта выполните java -version и команду Gradle wrapper: Linux/macOS ./gradlew --version, Windows gradlew.bat --version. Если JAVA_HOME is not set, переменная отсутствует/указывает не на JDK; если Unsupported class file major version, версия Java или Gradle не совместима со скомпилированным компонентом. Запишите обе версии прежде изменений.
  2. Найдите установленный JDKНа Windows откройте Проводник и найдите папку JDK, содержащую bin\java.exe, например внутри C:\Program Files\Java; на macOS выполните /usr/libexec/java_home -V; на Linux — readlink -f "$(command -v javac)". JAVA_HOME должен указывать на корень JDK без bin, а не на установщик или папку проекта.
  3. Установите подходящую версию и настройте окружениеСверьте файл gradle/wrapper/gradle-wrapper.properties, настройки проекта и таблицу совместимости Java/Gradle на официальном сайте Gradle. Для Windows откройте «Поиск → Изменение системных переменных среды → Переменные среды», задайте пользовательскую JAVA_HOME путём JDK; в Linux/macOS задайте переменную в конфигурации используемой оболочки. Не меняйте глобальную Java на сервере с другими проектами без согласования.
  4. Проверьте повторной сборкойОткройте новое окно терминала, убедитесь, что Gradle wrapper показывает требуемую JVM, затем запустите ./gradlew build или gradlew.bat build согласно ОС. Если сообщение о major version повторилось, сравните версию class file с версией JDK, проверьте плагины сборки; удаление .gradle вслепую не исправляет несовместимость версий.

#Если проблема осталась

Если «Gradle: JAVA_HOME is not set / Unsupported class file major version» повторяется, сохраните время, состояние подключения и точный текст ошибки. Не меняйте сразу несколько настроек — иначе станет трудно понять, какое действие повлияло на результат.

Так эту ошибку тоже называют

Сборка проекта падает: «JavaScript heap out of memory» — решение Node.js по умолчанию ограничивает память кучи. Крупные проекты при сборке могут её исчерпать. Увеличьте лимит параметром `--max-old-space-size` (например, `NODE_OPTIONS=… Программирование и базы данных Сборка проектов Node.js CMake: Could not find a package configuration file — причины и решение CMake не нашёл библиотеку, указанную в find_package: она не установлена либо находится в нестандартном каталоге. Ниже — причины и порядок действий от простого к сложному. Программирование и базы данных Сборка проектов LinuxWindowsmacOS gcc: fatal error — no such file or directory (отсутствует заголовочный файл) — причины и решение Компилятор не нашёл заголовочный файл: не установлен пакет разработки или путь включения не указан. Ниже — причины и порядок действий от простого к сложному. Программирование и базы данных Сборка проектов Linux make: *** No targets specified and no makefile found — причины и решение make ищет Makefile в текущем каталоге. Ниже — причины и порядок действий от простого к сложному. Программирование и базы данных Сборка проектов LinuxmacOS Webpack: Module not found: Can't resolve — причины и решение Ошибка Webpack «Module not found: Error: Can't resolve» вызвана отсутствующей зависимостью, неверным путём или регистром, неправильными alias и extensions, версионным ко… Программирование и базы данных Сборка проектов LinuxWindowsmacOS

Источники и обновления

Последнее обновление статьи: 2 ноября 2026. Версии программ и интерфейсы меняются — если шаги не совпадают с вашей версией, сверяйтесь с документацией производителя.