Spring Boot Java compatibility matrix - jak dobrać wersję JDK w 2026 roku

Marek Radoszewski Marek Radoszewski
• Narzędzia i Praktyki
21.11.2026 • 8 min
Spring Boot Java compatibility matrix - jak dobrać wersję JDK w 2026 roku

Spring Boot Java compatibility matrix w 2026 roku sprowadza się do zasady: dla nowych projektów wybierz JDK 25 LTS ze Spring Boot 4.0, dla aplikacji utrzymywanych na Spring Boot 3.5 bezpiecznym wyborem jest JDK 21 LTS, a JDK 17 zostaw tam, gdzie blokuje Cię stary kod.

Co naprawdę mówi spring boot java compatibility matrix

Ta spring boot java compatibility matrix nie jest tabelką na ścianę. Pokazuje, z jakimi wersjami JDK twórcy Spring Boot testują dany numer i jak długo dostaniesz wsparcie. Minimalna wersja to jedno, a zalecana wersja to drugie. W 2026 roku najczęściej chodzi o wybór między JDK 17, 21 i 25. Poniższa spring boot java compatibility matrix zbiera najważniejsze linie, które spotkasz w projektach.

Linia Spring Boot Minimalna Java Zalecana Java w 2026 Maksymalna testowana Java Kiedy wybrać
4.0 17 25 LTS 25 nowe aplikacje, najdłuższe wsparcie
3.5 17 21 LTS 24 utrzymanie i migracja z 3.x
3.4 17 21 LTS 23 krótkie utrzymanie, planuj podniesienie
3.3 17 21 po testach 22 legacy, bez nowych funkcji
3.2 i starsze 17 21 po testach zależy od wersji legacy, planuj upgrade
2.7 8 17 tylko awaryjnie 17 w praktyce legacy poza OSS, wysokie ryzyko

Z tabeli wynika prosta rzecz: Spring Boot 4.0 nie wymaga JDK 25, ale JDK 25 jest najlepszym wyborem dla nowego projektu. Spring Boot 3.5 nadal działa na JDK 17, jednak JDK 21 daje virtual threads i dłuższe wsparcie. JDK 17 zostaje dla zespołów, które mają bibliotekę bez wsparcia dla nowszej Javy albo środowisko produkcyjne, którego nie da się szybko zmienić.

Sam numer wersji Spring Boot nie wystarcza. Sprawdź też, czy Maven albo Gradle działa na wybranym JDK, czy IDE ogarnia nową składnię i czy obraz Dockera ma aktualną Javę. W polskich firmach często problemem nie jest sam Spring Boot, a stary agent APM, wtyczka do bazy albo skrypt wdrożeniowy. To one blokują przejście na JDK 21 lub 25, dlatego przy Spring Boot compatibility matrix warto sprawdzać też listę zależności.

Ilustracja do Spring Boot Java compatibility matrix pokazująca wybór JDK 25 LTS dla Spring Boot 4.0 i JDK 21 LTS dla wersji 3.5

JDK 17, 21 czy 25 - co wybrać w 2026 roku

JDK 17 nadal ma sens. To minimum dla Spring Boot 3.x i 4.0, więc dostaniesz wsparcie frameworka. Jeśli masz aplikację, która działa, nie ma znanych luk i nie planujesz nowych funkcji, zostawienie JDK 17 na chwilę jest dopuszczalne. Nie traktuj tego jednak jako celu. JDK 17 nie da Ci virtual threads, nowszych usprawnień GC i dłuższego okna wsparcia.

JDK 21 LTS to bezpieczny środek dla Spring Boot 3.5. Zespół Springa testuje tę linię z JDK 17-24, a JDK 21 jest wersją LTS. Dostajesz virtual threads, lepsze wsparcie dla kontenerów i nowsze API. W istniejącym projekcie to często najmniejszy krok, który daje realną korzyść bez skoku na Spring Boot 4.0.

JDK 25 LTS wybierz do nowych aplikacji na Spring Boot 4.0. To najnowsza wersja LTS w 2026 roku i najlepszy start dla projektu, który ma żyć kilka lat. Sprawdź tylko biblioteki, agentów JVM i narzędzia buildowe. Jeśli któraś zależność nie ma wsparcia dla JDK 25, nie walcz z nią na produkcji. Zejdź do JDK 21 i Spring Boot 3.5, a migrację zaplanuj osobno.

JDK 26 zostaw w laboratorium. To wersja non-LTS, więc nie ma sensu opierać na niej wdrożenia produkcyjnego. Spring Boot 4.0 testuje JDK 17-25. Nowsza Java może działać, ale nie masz oficjalnej gwarancji. W 2026 roku wystarczy Ci JDK 25 LTS.

Kiedy Spring Boot 4.0 i JDK 25 mają sens

Spring Boot 4.0 ma sens w nowym projekcie. Dostajesz nową linię wsparcia, nowsze Spring Framework i dłuższe okno aktualizacji. JDK 25 LTS pasuje do tego zestawu, bo nie musisz wracać do migracji Javy za rok. Jeśli budujesz nowe API, usługę do przetwarzania danych albo backend pod aplikację mobilną, start na 4.0 i JDK 25 jest rozsądny.

Pomocne jest też sprawdzenie, jaka jest najnowsza wersja Spring Boot i jak ją połączyć z JDK 25 LTS. W istniejącej aplikacji decyzja wygląda inaczej.

Spring Boot 4.0 zmienia sporo w zależnościach i konfiguracji. Nie przeskakuj z 2.7 od razu na 4.0. Najpierw podnieś projekt do 3.5 na JDK 17 albo 21, usuń ostrzeżenia, popraw testy i dopiero wtedy zaplanuj 4.0. Taka droga zajmuje więcej czasu, ale daje mniej niespodzianek.

Sprawdź też biblioteki, które lubią blokować migracje:

  • Lombok,
  • MapStruct,
  • Hibernate,
  • Testcontainers,
  • agent APM,
  • wtyczki do Maven albo Gradle.

Nie każda z nich działa od razu na JDK 25. Czasem wystarczy aktualizacja, czasem trzeba poczekać na wydanie. Lepiej wiedzieć to przed wdrożeniem niż po.

Jak dobrać JDK do istniejącej aplikacji

Zacznij od spisania wersji Spring Boot i Javy w każdym module. Sprawdź przy tym, jaki jest najnowszy Spring Boot i które wydanie jest aktualnie wspierane.

Potem sprawdź, które zależności mają wsparcie dla JDK 21 albo 25. Nie zakładaj, że skoro aplikacja się kompiluje, to wszystko działa. Uruchom testy integracyjne na nowym JDK i porównaj wyniki z obecnym środowiskiem.

Jeśli siedzisz na Spring Boot 2.7, najpierw przejdź na 3.5. To duży skok, ale nie da się go sensownie pominąć. Java 17 będzie tu minimum. Po udanej migracji możesz podnieść JDK do 21. Dopiero potem ocenisz, czy Spring Boot 4.0 i JDK 25 mają sens w Twoim przypadku.

Jeśli masz Spring Boot 3.5, wybierz JDK 21 LTS. To najmniej ryzykowny ruch. Jeśli chcesz JDK 25, zrób to razem z przejściem na Spring Boot 4.0. Nie mieszaj dwóch dużych zmian w jednym wdrożeniu, chyba że masz bardzo dobry zestaw testów i mały projekt.

W aplikacji, której nie możesz ruszyć, zostaw JDK 17. Zaplanuj jednak przegląd zależności co kilka miesięcy. Stary JDK to nie tylko brak nowych funkcji. To też krótsze wsparcie bezpieczeństwa i mniejsza pula ludzi, którzy znają dany stos.

Migracja krok po kroku bez przestojów

Zacznij od gałęzi technicznej i pełnego zestawu testów. Ustaw kompilację na nowe JDK, ale nie zmieniaj jeszcze produkcji. W Maven możesz użyć parametru --release, a w Gradle toolchaina. Dzięki temu build od razu pokaże, które fragmenty kodu nie przechodzą na nową Javę.

Potem uruchom aplikację lokalnie i na środowisku testowym. Sprawdź logi, zużycie pamięci, start aplikacji i testy integracyjne. Przy przejściu z JDK 17 na 21 zwróć uwagę na biblioteki, które korzystają z refleksji i agentów JVM. Przy JDK 25 sprawdź też obrazy Dockera i konfigurację CI.

Wdrożenie produkcyjne zrób etapami. Najpierw jeden mniej krytyczny serwis albo instancja za load balancerem. Obserwuj błędy, czas odpowiedzi i GC. Jeśli coś pójdzie nie tak, wróć do poprzedniego JDK bez zmiany kodu aplikacji. Taki rollback jest znacznie łatwiejszy, gdy nie łączysz migracji Javy z przebudową całego systemu.

Jak testować zgodność JDK ze Spring Boot

Testy na jednym JDK nie wystarczą. Ustaw w CI macierz z JDK 21 i JDK 25, jeśli projekt ma przejść na Spring Boot 4.0. Dla Spring Boot 3.5 trzymaj JDK 17 i 21. Dzięki temu szybko zobaczysz, która zależność psuje build na nowszej Javie.

Sprawdź nie tylko testy jednostkowe. Uruchom testy integracyjne, start całego kontekstu Springa i testy z Testcontainers. Jeśli używasz agenta APM, przetestuj go na nowym JDK. To samo dotyczy narzędzi do mockowania, generowania kodu i migracji bazy.

Czytaj release notes bibliotek. Jeśli projekt nie deklaruje wsparcia dla JDK 25, nie licz na cud. Możesz zrobić próbę, ale wynik traktuj jako eksperyment. W produkcji potrzebujesz wsparcia, a nie tego, że „u mnie działa”.

Grafika ilustrująca testowanie Spring Boot Java compatibility matrix w CI na JDK 21 i JDK 25 oraz wybór wersji do produkcji

Najczęstsze pytania

Jaka wersja Javy jest wymagana przez Spring Boot 4?

Spring Boot 4.0 wymaga minimum JDK 17, ale zespół projektu testuje go z JDK 17-25. Do nowego wdrożenia wybierz JDK 25 LTS, bo dostajesz dłuższe wsparcie i nowsze funkcje JVM. JDK 17 ma sens tylko wtedy, gdy blokuje Cię biblioteka albo środowisko produkcyjne. Samo minimum nie wystarcza do decyzji o produkcji.

Czy Spring Boot 3.5 działa z Java 25?

Spring Boot 3.5 był testowany z JDK 17-24. JDK 25 może wystartować, ale nie masz oficjalnej gwarancji. Do produkcji na 3.5 wybierz JDK 21 LTS. Jeśli chcesz JDK 25, zaplanuj przejście na Spring Boot 4.0 i przetestuj cały stos. Wtedy unikniesz niespodzianek w bibliotekach i agentach JVM.

Jaki JDK wybrać do nowego projektu w 2026?

Do nowego projektu w 2026 roku wybierz JDK 25 LTS i Spring Boot 4.0. Ten zestaw daje najdłuższe wsparcie i dostęp do nowych funkcji JVM. Jeśli jedna z bibliotek nie działa na JDK 25, cofnij się do JDK 21 LTS ze Spring Boot 3.5. Nie wybieraj JDK 26, bo to wersja non-LTS.

Czy mogę używać JDK 26 ze Spring Boot?

JDK 26 to wersja non-LTS, więc nie jest dobrym wyborem do produkcji. Spring Boot 4.0 testuje JDK 17-25. Możesz sprawdzić JDK 26 w laboratorium, ale nie opieraj na nim wdrożenia. Poczekaj na oficjalne wsparcie w kolejnej linii Spring Boot. W 2026 roku bezpieczniejszy jest JDK 25 LTS.

Jak sprawdzić, czy biblioteka działa na JDK 25?

Sprawdź release notes biblioteki, potem uruchom pełny build i testy integracyjne na JDK 25. Zwróć uwagę na agentów JVM, Lomboka, MapStruct, Byte Buddy i wtyczki do Maven albo Gradle. Testy w CI na dwóch JDK pokażą różnice szybciej niż ręczne klikanie. Jeśli biblioteka nie ma wsparcia, zostajesz na JDK 21.

Czy JDK 17 wystarczy w 2026 roku?

JDK 17 wystarczy, jeśli aplikacja działa na Spring Boot 3.x albo 4.0 i nie możesz podnieść bibliotek. Stracisz jednak virtual threads, nowsze poprawki GC i dłuższe wsparcie. W 2026 roku traktuj JDK 17 jako etap przejściowy. Zaplanuj migrację do JDK 21 albo 25 w ciągu najbliższych miesięcy.

Marek Radoszewski

Autor

Marek Radoszewski

Freelance developer i tech blogger od 7 lat. Pracował przy projektach dla klientów z Polski, UK i USA. Na blogu pisze o praktycznych aspektach programowania, narzędziach i tym, jak skutecznie rozwijać karierę jako niezależny programista.

← Wróć do kategorii Narzędzia i Praktyki