Міграція з Java Spring Boot 2 / 3 на Spring Boot 4

Перехід на нові мажорні версії фреймворків завжди викликає у розробників змішані почуття: з одного боку — нові оптимізації та можливості, з іншого — головний біль через застарілі компоненти та зміну конфігурацій. Вихід Spring Boot 4 (на базі Spring Framework 7 та Jakarta EE 11) знаменує новий етап розвитку платформи. Що чекає на команди, які планують міграцію зі старих версій (2.x або 3.x) на актуальний стек?


Що змінилося в підґрунті платформи?

Головна відмінність міграції полягає у тому, звідки ви переходите:

  1. Зі Spring Boot 3.x: Перехід буде значно плавстішим. Оскільки версія 3 вже перевела екосистему на простір імен jakarta.*, перехід на Boot 4 (Servlet 6.1) не вимагатиме глобального переписування пакетів імпорту.
  2. Зі 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 мс) та значно менше споживання пам’яті.

Покроковий план міграції

  1. Оновіть Java-базовий рівень: Переконайтеся, що ваш проєкт збирається на Java 17+, а краще — на Java 21.
  2. Проведіть проміжне оновлення до Spring Boot 3.5: Якщо ваш застосунок досі працює на старій версії, спершу підніміть його до фінальної гілки 3.5.x. Це дозволить закрити всі застарілі попередження (deprecations), які у Boot 4 повністю видалені.
  3. Перевірте сторонні бібліотеки та середовища виконання:
    • Сервери сервлетів такі як Tomcat 11 та Jetty 12 підтримуються повноцінно.
    • Важливо: Сервер Undertow на момент перших релізів Boot 4 не підтримується через нюанси сумісності з Servlet 6.1. Перевірте сумісність бібліотек безпеки та Jackson-модулів.
  4. Використовуйте інструменти автоматизації (OpenRewrite): Спеціальні рецепти OpenRewrite від команди Spring допоможуть автоматично рефакторити конфігурації та великі масиви застарілого коду.
  5. Ретельне тестування (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();
}
Java

2. Декларативні 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=5s
Plaintext

3. Компіляційна безпека типів (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;
Plaintext

2. Міграція 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:8888
Plaintext

✅ Сучасний підхід (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:8888
Plaintext

Якщо ви розбиваєте єдиний великий application.yml на кілька модульних файлів, імпортуйте їх так само через spring.config.import:

# application.yml
spring:
  config:
    import:
      - optional:classpath:database.yml
      - optional:classpath:security.yml
YAML

💡 Порада: Як безболісно знайти всі застарілі параметри конфігурацій

Оскільки у 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 цей модуль просканує ваші файли властивостей, виведе в лог попередження про всі застарілі ключі та тимчасово запустить їхню трансляцію, що дозволить вам швидко оновити конфігурацію перед релізом у продакшн.

javaadmin

Супер крутий Dev

Related Posts

Робота з базами даних у Spring: порівнюємо JDBC, Hibernate та Spring Data JPA

Робота з базами даних — одна з найважливіших складових практично будь-якого backend-застосунку. Spring пропонує кілька рівнів абстракції для доступу до даних: низькорівневий Spring JDBC, потужний ORM-фреймворк Hibernate та зручну надбудову Spring Data JPA. Розглянемо, чим вони відрізняються, коли варто обирати кожен з них. 1. Spring JDBC Spring JDBC — це тонка обгортка над стандартним java.sql, яка усуває бойлерплейт-код: ручне відкриття/закриття з’єднань, обробку виключень, керування транзакціями. Основний інструмент — клас JdbcTemplate: Переваги: Недоліки: Spring JDBC…

Dependency Injection у Spring: пояснюємо на пальцях

Коли програміст-початківець вперше відкриває документацію до Spring Framework, на нього одразу висипається купа грізних термінів: Dependency Injection (DI), Inversion of Control (IoC), ApplicationContext, Bean. Здається, що це вища математика. Ми вже розглядали DI в минулих матеріалах але цю дуже не просту тему краще розібрати по болтиках для повного розуміння. Насправді за цими розумними словами ховається надзвичайно проста та красива ідея. Це історія про те, як перестати збирати складні речі вручну й довірити…

Цікаве

Nagad88 mobile app review: a seamless betting experience for Bangladesh players

Les jeux Crash et Turbo sur Tower Rush : un monde de gains à

Como começar a jogar no TopX Casino Online: guia prático para iniciantes

Lazybar καζίνο: οι κορυφαίοι λόγοι για να επιλέξετε αυτό το καζίνο

Registro en Beton Win: pasos sencillos para crear tu cuenta en Chile

Snelle uitbetalingen bij LuckyGem Casino: hoe je moeiteloos je winst kunt opnemen