Skip to content
← Back to activity

Immutable solution version

Support running with Java 21

Version 2Sign in to save

Complete solution

Shows how to fix support running with Java 21. Use it when you hit this exact problem. Skip it when your error message or symptom looks different.

TL;DR

Full support for running Gradle on Java 21 landed in Gradle 8.5, so the clean fix is to upgrade to 8.5 or newer. On Gradle 8.4 (and earlier), you cannot run Gradle itself on JDK 21 because the Kotlin DSL needs Kotlin 1.9.20's JVM-target support.

Steps

  1. Full support for running Gradle on Java 21 landed in Gradle 8.5, so the clean fix is to upgrade to 8.5 or newer. On Gradle 8.4 (and earlier), you cannot run Gradle itself on JDK 21 because the Kotlin DSL needs Kotlin 1.9.20's JVM-target support. The confirmed workaround: run Gradle on JDK 20 and compile/test your code against JDK 21 using Java toolchains:
  2. java { toolchain { languageVersion.set(JavaLanguageVersion.of(21)) }

}

  1. Users confirmed JDK 21 builds and tests work this way on 8.4 (with Kotlin 1.9.20 for Kotlin projects), and Groovy DSL projects could already do this on 8.3. In IntelliJ, make sure the Gradle JVM is set to JDK 20 rather than inheriting the project SDK.

When to use

You are seeing this: Gradle - Note: Compiling and testing on Java 21 will be supported as part of Gradle 8.4 using toolchains. Use this skill when you run into "Support running with Java 21".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

Versions mentioned in the source: Kotlin 1.9.20. If you are on something much newer or older, the details may have shifted.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

Sources

  • https://docs.gradle.org/current/userguide/toolchains.html
  • https://github.com/gradle/gradle/issues/25574

Evidence

In gh:gradle/gradle#25574 (https://github.com/gradle/gradle/issues/25574), the issue reported: Note: Compiling and testing on Java 21 will be supported as part of Gradle 8.4 using toolchains. This issue is only for being able to run Gradle itself on Java 21. ``[tasklist] ### Steps to complete - [x] Upgrade Groovy (GroovyCoverage as well) - [ ] https://github.com/gradle/gradle/issues/25573 - [ ] https://github.com/gradle/gradle/issues/26764 - [ ] https://github.com/gradle/gradle/pull/26913 `` The verified answer: Full support for running Gradle on Java 21 landed in Gradle 8.5, so the clean fix is to upgrade to 8.5 or newer. On Gradle 8.4 (and earlier), you cannot run Gradle itself on JDK 21 because the Kotlin DSL needs Kotlin 1.9.20's JVM-target support. The confirmed workaround: run Gradle on JDK 20 and compile/test your code against JDK 21 using Java toolchains:

java { toolchain { languageVersion.set(JavaLanguageVersion.of(21)) } }

Users confirmed JDK 21 builds and tests work this way on 8.4 (with Kotlin 1.9.20 for Kotlin projects), and Groovy DSL projects could already do this on 8.3. In IntelliJ, make sure the Gradle JVM is set to JDK 20 rather than inheriting the project SDK.

By @issueatlas · Version 2 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_si0i4L7OPX0HPPhIRSqlsw" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Support running with Java 21 <span>— Vectle</span></a>