Ошибка Invalid Gradle JDK configuration found или сообщение о том, что Android Studio не может найти JDK, появляется при запуске проекта, когда путь к Java Development Kit указан неверно, указывает на удалённую папку или вовсе не задан после переустановки IDE. Проверить это можно сразу: откройте File → Project Structure → SDK Location и посмотрите, какой путь указан в поле Gradle JDK — если строка пустая, подсвечена красным или ведёт в несуществующий каталог, причина найдена.
Начиная с современных версий Android Studio, среда поставляется со встроенным JDK (так называемый jbr — JetBrains Runtime), поэтому в большинстве случаев отдельная установка Java не требуется. Однако при переносе проектов, обновлении IDE или ручной настройке переменных среды путь может «слететь», и сборка Gradle перестаёт запускаться. Ниже разберём, где лежит JDK, как его найти и правильно прописать.
Где Android Studio хранит JDK по умолчанию
Встроенный JetBrains Runtime устанавливается вместе со средой разработки и лежит в каталоге самой Android Studio. Типовые пути зависят от операционной системы, поэтому ориентируйтесь на свою платформу.
- 🪟 Windows: обычно это
C:\Program Files\Android\Android Studio\jbr(в старых версиях — папкаjre). - 🍎 macOS: внутри пакета приложения, примерно
/Applications/Android Studio.app/Contents/jbr/Contents/Home. - 🐧 Linux: каталог
jbrвнутри папки, куда распакована Android Studio.
Если папки jbr нет, возможно, установка неполная или среда была обновлена со старой версии. В таком случае проще всего указать внешний JDK либо переустановить Android Studio с официального источника.
Как узнать текущий JDK path в Android Studio
Самый надёжный способ — посмотреть настройки проекта. Откройте File → Project Structure (сочетание Ctrl+Alt+Shift+S на Windows/Linux), перейдите в раздел SDK Location и найдите пункт Gradle JDK (в некоторых версиях — JDK location). Там будет указан либо встроенный JDK, либо полный путь к внешнему.
Второй вариант — через настройки Gradle: File → Settings → Build, Execution, Deployment → Build Tools → Gradle. Выпадающий список Gradle JDK показывает, какая Java используется для сборки. Если в списке стоит «Embedded JDK», значит, задействован встроенный рантайм.
Как изменить JDK path через настройки проекта
Смена пути выполняется в том же окне Project Structure. Порядок действий несложный, но важно указывать именно корневую папку JDK, а не подкаталог bin — это частая ошибка.
☑️ Как сменить JDK path в Android Studio
После смены пути Android Studio запустит повторную синхронизацию Gradle. Если синхронизация завершилась без ошибок — новый путь принят. Если появилось сообщение вида Supplied javaHome seems to be invalid, проверьте, что в указанной папке действительно есть подкаталоги bin, lib и файл release.
⚠️ Внимание: указывайте корень установки JDK, а не папкуbinи не путь кjava.exe. Неверный уровень каталога — самая частая причина ошибки «invalid JDK location».
Настройка через переменные среды и gradle.properties
Помимо настроек IDE, путь к Java может задаваться системно. Переменная среды JAVA_HOME используется при запуске Gradle из командной строки и некоторыми скриптами сборки. На Windows её можно задать через Параметры → Система → О системе → Дополнительные параметры системы → Переменные среды, указав путь к корню JDK.
Ещё один способ — файл gradle.properties в корне проекта или в пользовательском каталоге Gradle. Туда добавляется строка вида:
org.gradle.java.home=C:\\Program Files\\Java\\jdk-17Обратите внимание: в gradle.properties на Windows обратные слеши нужно экранировать двойными. Параметр из gradle.properties имеет приоритет над настройками IDE для конкретного проекта, что удобно при работе в команде с разными окружениями.
Типичные ошибки и их решение
Чаще всего проблемы с JDK path проявляются в виде ошибок при синхронизации или сборке. Ниже — таблица типовых симптомов и действий.
| Симптом | Вероятная причина | Что делать |
|---|---|---|
| Invalid Gradle JDK configuration | Путь указывает на удалённую или перемещённую папку | Задать путь заново в Project Structure |
| Supplied javaHome seems to be invalid | Указана папка bin вместо корня JDK | Подняться на уровень выше, выбрать корень JDK |
| Unsupported class file major version | Несовместимость версии Java с версией Gradle/AGP | Выбрать JDK совместимой версии для вашего проекта |
| JAVA_HOME is not set | Переменная среды не задана или задана неверно | Прописать JAVA_HOME на корень установленного JDK |
Отдельно отметим ошибку несовместимости версий: версия Java, которой собирается проект, должна поддерживаться используемой версией Android Gradle Plugin и Gradle. Точную совместимость для вашей связки AGP/Gradle стоит сверять с официальной документацией Android Developers, так как требования меняются от релиза к релизу.
⚠️ Внимание: не прописывайте путь к JDK вручную в файлах внутри папки.idea— эти конфиги перезаписываются IDE, и ручные правки могут сломать синхронизацию. Все изменения выполняйте через интерфейс настроек илиgradle.properties.
Где Android Studio хранит путь к JDK в файлах
Выбранный JDK для Gradle сохраняется в файле .idea/gradle.xml (параметр gradleJvm) и/или в gradle.properties (org.gradle.java.home). Пути из .idea локальны для машины и обычно не коммитятся в систему контроля версий.
Что делать, если ничего не помогло
Если после смены пути ошибки остаются, последовательно проверьте следующее. Сначала очистите кэш сборки: File → Invalidate Caches → Invalidate and Restart. Затем удалите локальные папки .gradle и build в проекте и выполните синхронизацию заново — повреждённые кэши иногда «держат» старый путь.
Крайний вариант — переустановка Android Studio с чистой конфигурацией. Перед этим сохраните проекты и настройки (их можно экспортировать через File → Manage IDE Settings → Export Settings). После чистой установки IDE подтянет свежий встроенный jbr, и проблема с путём обычно исчезает.
Частые вопросы (FAQ)
Нужно ли отдельно устанавливать JDK для Android Studio?
Нет, современные версии Android Studio поставляются со встроенным JetBrains Runtime, которого достаточно для разработки и сборки проектов. Отдельный JDK нужен только в особых случаях — например, если проект требует конкретную версию Java.
Чем отличается JDK location от Gradle JDK?
Это, по сути, одна и та же настройка в разных версиях интерфейса: она определяет, какая Java используется для запуска Gradle-сборки проекта. В новых версиях IDE пункт называется Gradle JDK и находится в разделе SDK Location.
Можно ли использовать разные JDK для разных проектов?
Да. Настройка Gradle JDK задаётся на уровне проекта, а параметр org.gradle.java.home в gradle.properties конкретного проекта позволяет закрепить нужную версию Java независимо от глобальных настроек.
Почему Gradle из терминала использует другую Java, чем IDE?
Командная строка ориентируется на переменную среды JAVA_HOME, а Android Studio — на свою настройку Gradle JDK. Если они указывают на разные установки Java, результаты сборки могут отличаться. Приведите оба значения к одному JDK.
Где скачать внешний JDK, если встроенный не подходит?
Можно использовать официальный Oracle JDK или свободные сборки OpenJDK (например, Eclipse Temurin). Перед установкой сверьте требуемую версию Java с документацией к используемой версии Android Gradle Plugin.