Gradle: Unsupported class file major version / Android Gradle plugin requires Java 17 to run
The JDK running Gradle doesn’t match what the Gradle version or Android Gradle Plugin (AGP) supports.
Unsupported class file major versionAndroid Gradle plugin requires Java 17 to runUnsupported JavaIncompatible Gradle JVM Meaning
AGP 8.x requires JDK 17+, while old Gradle versions can’t run on new JDKs (“Unsupported class file major version 65” = JDK 21 on an old Gradle). Android Studio’s Gradle JDK setting, JAVA_HOME and CI images often disagree.
Common causes
- AGP 8 with JDK 11 (“requires Java 17”)
- Old Gradle wrapper with JDK 21+ (major version 65)
- CI image JDK differs from Android Studio’s embedded JDK
- JAVA_HOME pointing to a different JDK than Studio
⚡ Quick fix
- Settings → Build Tools → Gradle → Gradle JDK: select JDK 17 (embedded JBR)
- Upgrade the Gradle wrapper for newer JDKs
- Set JAVA_HOME / setup-java to 17 in CI
Detailed fix by platform
Android
- Check and upgrade the wrapper:bash
./gradlew --version # shows Gradle version and the JVM it runs on ./gradlew wrapper --gradle-version 8.7 # GitHub Actions: # - uses: actions/setup-java@v4 # with: { distribution: temurin, java-version: '17' }
How to diagnose
- JVM — Which JDK runs Gradle (
gradlew --version)? - Versions — AGP ↔ Gradle ↔ JDK compatibility
- Environment — Studio vs CLI vs CI differences
🔧 Still not fixed?
Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:
Similar errors
Most viewed in Android
- INSTALL_FAILED_USER_RESTRICTED INSTALL_FAILED_USER_RESTRICTED: Install canceled by user (Xiaomi/MIUI, Oppo, Vivo)
- INSTALL_PARSE_FAILED_NO_CERTIFICATES INSTALL_PARSE_FAILED_NO_CERTIFICATES / App not installed as package appears to be invalid
- INSTALL_FAILED_OLDER_SDK INSTALL_FAILED_OLDER_SDK / INSTALL_FAILED_DEPRECATED_SDK_VERSION
Other ways to find it
Where this error sits
Origin: On your device. Errors that are often confused with or caused by this one (click to open):
🧠 Still stuck? Analyze your error
Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.
💬 What worked for others
No tips yet — did something else fix this for you?
Share what worked for you
Tips are checked by an editor before they appear. Links are removed.
Report a correction or suggest an improvement
Last updated 14 Oct 2026