Перехід на нові мажорні версії фреймворків завжди викликає у розробників змішані почуття: з одного боку — нові оптимізації та можливості, з іншого — головний біль через застарілі компоненти та зміну конфігурацій. Вихід Spring Boot 4 (на базі Spring Framework 7 та Jakarta EE 11) знаменує новий етап розвитку платформи. Що чекає на команди, які планують міграцію зі старих версій (2.x або 3.x) на актуальний стек?
Що змінилося в підґрунті платформи?
Головна відмінність міграції полягає у тому, звідки ви переходите:
- Зі Spring Boot 3.x: Перехід буде значно плавстішим. Оскільки версія 3 вже перевела екосистему на простір імен
jakarta.*, перехід на Boot 4 (Servlet 6.1) не вимагатиме глобального переписування пакетів імпорту. - Зі Spring Boot 2.x: Тут на вас чекає подвійний стрибок. Спочатку доведеться пройти через етап оновлення на Spring Boot 3 (де відбулася зміна з
javax.*наjakarta.*), оскільки підтримка версії 2 давно завершилася.
Для роботи зі Spring Boot 4 мінімальною вимогою є Java 17, проте настійно рекомендується використовувати Java 21 або вище, щоб повноцінно задіяти віртуальні потоки (virtual threads) та сучасні механізми продуктивності JVM.
Основні нові можливості, заради яких варто мігрувати
- Декларативні HTTP-клієнти: Забудьте про написання рутинного boilerplates-коду для
WebClientчиRestTemplate. Spring Boot 4 підтримує зручні інтерфейсні клієнти через@HttpExchange. - Нативна підтримка версіонування API: Маршрутизація версій (
v1,v2) тепер вбудована на рівні Spring MVC/WebFlux. - Безпека типів на етапі компіляції (JSpecify): Використання стандартів анотацій
@NullMarkedта@Nullableдопомагає уникнутиNullPointerExceptionще до запуску програми. - Висока продуктивність GraalVM AOT: Покращена Ahead-of-Time компіляція забезпечує рекордний час старту додатків (менше 100 мс) та значно менше споживання пам’яті.
Покроковий план міграції
- Оновіть Java-базовий рівень: Переконайтеся, що ваш проєкт збирається на Java 17+, а краще — на Java 21.
- Проведіть проміжне оновлення до Spring Boot 3.5: Якщо ваш застосунок досі працює на старій версії, спершу підніміть його до фінальної гілки 3.5.x. Це дозволить закрити всі застарілі попередження (deprecations), які у Boot 4 повністю видалені.
- Перевірте сторонні бібліотеки та середовища виконання:
- Сервери сервлетів такі як Tomcat 11 та Jetty 12 підтримуються повноцінно.
- Важливо: Сервер Undertow на момент перших релізів Boot 4 не підтримується через нюанси сумісності з Servlet 6.1. Перевірте сумісність бібліотек безпеки та Jackson-модулів.
- Використовуйте інструменти автоматизації (OpenRewrite): Спеціальні рецепти OpenRewrite від команди Spring допоможуть автоматично рефакторити конфігурації та великі масиви застарілого коду.
- Ретельне тестування (Spring Security 7 та Hibernate 7): Оновлені інструменти безпеки та persistence-шару вимагають покриття інтеграційними тестами (наприклад, через Testcontainers) для перевірки коректності транзакцій та фільтрації доступу.
1. Перехід Spring Security: Відмова від ланцюжків .and()
У Spring Security 7 повністю видалено застарілий стиль побудови конфігурацій із викликами .and(). Тепер підтримується тільки чистий Lambda DSL, а правила матчингу запитів стали суворішими.
❌ Було (Spring Boot 2 / 3.x — код більше не компілюється):
@Bean
public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
http
.authorizeHttpRequests(auth -> auth
.antMatchers("/public/**").permitAll() // Старий antMatchers
.anyRequest().authenticated()
)
.csrf(csrf -> csrf.disable())
.and() // ❌ Метод видалено у Spring Security 7
.formLogin(Customizer.withDefaults());
return http.build();
}Java✅ Стало (Spring Boot 4 / Security 7):
@Bean
public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
http
.authorizeHttpRequests(auth -> auth
.requestMatchers("/public/**").permitAll() // Сучасний requestMatchers
.anyRequest().authenticated()
)
.csrf(csrf -> csrf.disable())
.formLogin(form -> form
.loginPage("/login")
.permitAll()
);
return http.build();
}Java2. Декларативні HTTP-клієнти замість ручного шаблонного коду
Замість того, щоб вручну конфігурувати WebClient або писати багаторядкові клієнти, Spring Boot 4 дозволяє описувати зовнішні виклики за допомогою звичайних інтерфейсів та анотацій @HttpExchange.
Оголошення клієнта:
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.service.annotation.GetExchange;
import org.springframework.service.annotation.HttpExchange;
import org.springframework.service.annotation.PostExchange;
@HttpExchange("/orders")
public interface OrderServiceClient {
@GetExchange("/{id}")
Order getOrderById(@PathVariable("id") String id);
@PostExchange
Order createOrder(@RequestBody Order newOrder);
}JavaЗручна конфігурація через application.properties:
Замість складних WebClient бінів, базові урли та таймаути задаються декларативно:
spring.http.client.service.group.order-service.base-url=https://api.example.com/v2
spring.http.client.service.group.order-service.read-timeout=5sPlaintext3. Компіляційна безпека типів (Null Safety) через JSpecify
Spring Boot 4 активно інтегрує стандарт JSpecify, дозволяючи виловлювати потенційні NullPointerException ще на етапі компіляції за допомогою анотацій @NullMarked та @Nullable.
package com.example.domain;
import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import org.jspecify.annotations.NullMarked;
import org.jspecify.annotations.Nullable;
@NullMarked // Вказує компілятору, що всі поля та методи за замовчуванням НЕ можуть бути null
@Entity
public class UserProfile {
@Id
private Long id;
private String username; // Гарантовано не null
private @Nullable String bio; // Явно дозволене null-значення
public String getUsername() {
return username;
}
public @Nullable String getBio() {
return bio;
}
}JavaЩе потрібно сказати пару слів щодо двох критичних аспектів міграції: зміни пакетів імпорту (Imports) та відмови від старого механізму bootstrap на користь сучасної конфігураційної архітектури у Spring Boot 4.
1. Ще раз про зміни в Imports
Характер і масштаб змін імпортів залежить від того, з якої саме версії ви мігруєте:
- Перехід зі Spring Boot 3.x на Spring Boot 4.0:
Це найбезболісніший шлях щодо пакетів імпорту. Оскільки у Spring Boot 3 вже відбувся фундаментальний перехід на простір імен Jakarta EE (jakarta.servlet.*,jakarta.persistence.*,jakarta.validation.*тощо замість застарілихjavax.*), у версії 4 пакети залишаються сумісними з екосистемою Jakarta EE 11. Головні зміни в імпортах стосуватимуться лише оновлених внутрішніх API фреймворку (наприклад, нових пакетів Spring Security 7 та JSpecify для null-безпеки). - Перехід зі Spring Boot 2.x безпосередньо на Spring Boot 4.0:
Якщо ваш застосунок досі на версії 2, вам доведеться масово замінювати всі пакетиjavax.*наjakarta.*.
Основні класичні заміни імпортів (javax ➔ jakarta):
// ❌ Було у Spring Boot 2.x
import javax.persistence.Entity;
import javax.persistence.Id;
import javax.servlet.http.HttpServletRequest;
import javax.validation.constraints.NotNull;
// ✅ Стало у Spring Boot 3.x та 4.0 (Jakarta EE 11)
import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.validation.constraints.NotNull;JavaНові імпорти для компіляційної null-безпеки (Spring Boot 4 / JSpecify):
import org.jspecify.annotations.NullMarked;
import org.jspecify.annotations.Nullable;Plaintext2. Міграція bootstrap.yml / bootstrap.properties
У сучасній екосистемі Spring Boot (починаючи з появи Config Data API у версії 2.4 і остаточно закріпленій у версії 4) окрема фаза раннього завантаження контексту через bootstrap.yml вважається застарілою.
- Що змінилося: Раніше для підключення до зовнішніх конфігура-серверів (Spring Cloud Config, HashiCorp Vault тощо) обов’язково потрібен був файл
bootstrap.properties. У Spring Boot 4 цей механізм винесено за замовчування або переведено в статус legacy. - Як робити правильно тепер: Використовувати властивість
spring.config.importбезпосередньо у стандартномуapplication.propertiesабоapplication.yml.
❌ Старий підхід (bootstrap.properties / YAML):
# bootstrap.properties (застаріло у сучасних архітектурах)
spring.application.name=my-service
spring.cloud.config.uri=http://config-server:8888Plaintext✅ Сучасний підхід (Spring Boot 4 / Config Data API):
Усю зовнішню конфігурацію чи модульні файли тепер підключають через єдину точку в application.properties:
# application.properties
spring.application.name=my-service
# Підключення Config Server або локальних файлів у стандартному циклі старту
spring.config.import=optional:configserver:http://config-server:8888PlaintextЯкщо ви розбиваєте єдиний великий application.yml на кілька модульних файлів, імпортуйте їх так само через spring.config.import:
# application.yml
spring:
config:
import:
- optional:classpath:database.yml
- optional:classpath:security.ymlYAML💡 Порада: Як безболісно знайти всі застарілі параметри конфігурацій
Оскільки у Spring Boot 4 чимало налаштувань у конфігураційних файлах було перейменовано або видалено, тимчасово додайте у свій проєкт спеціальний інструмент Properties Migrator:
- Maven: xml
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-properties-migrator</artifactId> <scope>runtime</scope> </dependency>
Під час запуску програми на Spring Boot 4 цей модуль просканує ваші файли властивостей, виведе в лог попередження про всі застарілі ключі та тимчасово запустить їхню трансляцію, що дозволить вам швидко оновити конфігурацію перед релізом у продакшн.

