Spring Version Compatibility Cheatsheet

Updated: at 12:00 PM

This is a living reference page — I keep it updated as versions and details change.

Quick lookup tables for aligning your JDK, Gradle, Spring Boot, and Spring Cloud versions. Kept current as new versions ship — bookmark it. For the official, authoritative matrix, see Spring’s Support Mapping.

Jump to: Spring Boot ↔ Java · Spring Cloud ↔ Spring Boot · Gradle ↔ Java

Spring Boot ↔ Java

Spring Boot VersionCompatible Java Versions (Min - Max Targeted)
4.1.xJava 17 - 26
4.0.xJava 17 - 25
3.5.xJava 17 - 25
3.4.xJava 17 - 25
3.3.xJava 17 - 25
3.0.x - 3.2.xJava 17 - 21
2.7.xJava 8 - 21
2.6.xJava 8 - 19
2.5.xJava 8 - 18
2.4.xJava 8 - 16
2.2.x - 2.3.xJava 8 - 15
2.1.xJava 8 - 12
2.0.xJava 8 - 9
1.5.xJava 6 - 8

Spring Boot 4.x and 3.x baseline on Java 17. Source: endoflife.date.

Spring Cloud ↔ Spring Boot

Spring Cloud Release TrainCorresponding Spring Boot Version
2025.1.x (Oakwood)Spring Boot 4.0.x / 4.1.x
2025.0.x (Northfields)Spring Boot 3.5.x
2024.0.x (Moorgate)Spring Boot 3.4.x
2023.0.x (Leyton)Spring Boot 3.2.x / 3.3.x
2022.0.x (Kilburn)Spring Boot 3.0.x / 3.1.x
2021.0.x (Jubilee)Spring Boot 2.6.x / 2.7.x
2020.0.x (Ilford)Spring Boot 2.4.x / 2.5.x
HoxtonSpring Boot 2.2.x / 2.3.x
GreenwichSpring Boot 2.1.x
FinchleySpring Boot 2.0.x
EdgwareSpring Boot 1.5.x

Don’t mix trains and Boot versions arbitrarily — always confirm against the specific release train’s docs.

Gradle ↔ Java

Gradle VersionLatest Supported Java Version
9.4Java 26
9.1Java 25
8.14Java 24
8.10Java 23
8.8Java 22
8.5Java 21
8.3Java 20
7.6Java 19
7.5Java 18
7.3Java 17
7.0Java 16
6.7Java 15

Shows the Gradle version that first added support for running on each Java release (latest is Gradle 9.6, June 2026). You can still target older bytecode via toolchains. Source: Gradle compatibility docs.

Disclaimer: Version compatibility changes over time. Always confirm against the official Gradle, Spring Boot, and Spring Cloud documentation for your project.