Вышел Spring Boot 4.2. Что поменяется, если просто обновить версию?

Всем привет! Меня зовут Михаил Поливаха, я технический лидер проекта Axelix, AI Native платформы для Java-разработки.
19 ноября вышел Spring Boot 4.2.0. В нём появился AMQP 1.0, executable JAR-ы стали быстрее стартовать, а RestTemplate официально начал свой путь к удалению.
Представьте, что у вас сервис на Boot 4.1, который работает с RabbitMQ. Вы обновляете версию Boot, открываете свой pom.xml, а там всё тот же spring-boot-starter-amqp. Казалось бы, чего тут проверять-то? Так вот, в 4.2 этот стартер подключает поддержку другого протокола, и так можно сломать продакшен.
Давайте разберёмся, откуда это взялось, что ещё может поменяться при обычном обновлении и какие фичи в 4.2 я бы попробовал отдельно. За основу возьмём официальные release notes.
P.S: В рамках Axelix, поддержка Spring Boot 4.2 релизной линии будет внесена в 1.4 minor release и будет забекпорчена в 1.3.x release line, согласно support policy (любопытный факт - у нас она больше похожа на политику поддержки Quarkus, но не на Spring Boot, хотя Quarkus мы пока не поддерживаем).
RestTemplate. Вот теперь deprecated
С RestTemplate давно была забавная ситуация. Если вы писали новый синхронный HTTP-клиент, вам уже советовали RestClient. При этом в существующем проекте могло быть десять интеграций на RestTemplate, и какого-то особого повода их массово переписывать у команды не было.
В Spring Framework 7.1 RestTemplate пометили как deprecated с намерением удалить. Вслед за ним Boot 4.2 задепрекейтил свою инфраструктуру, включая RestTemplateBuilder, RestTemplateCustomizer и соответствующие автоконфигурации. Если у вас есть клиент для условного каталога, базовая миграция выглядит примерно так.
@Bean
RestClient catalogClient(
RestClient.Builder builder,
@Value("${catalog.base-url}") String baseUrl) {
return builder.baseUrl(baseUrl).build();
}
Дальше на месте условного getForObject у вас появится что-то вроде catalogClient.get().uri("/products/{id}", id).retrieve().body(Product.class). Но я бы при миграции сначала открыл конфигурацию старого билдера. Где там выставляются таймауты? Кто добавляет заголовки? Есть ли свой обработчик ошибок?
Если общие настройки раньше приезжали через бин RestTemplateCustomizer, их нужно перенести на RestClientCustomizer. Переписать один вызов проще, чем потом выяснять, почему новый клиент иначе ведёт себя на 404.
Отдельно задепрекейтили TestRestTemplate. Для тестов самого приложения есть RestTestClient и @AutoConfigureRestTestClient. В зависимости от типа теста клиент работает с mock-транспортом или ходит в реально запущенный сервер. А если у вас уже есть @RestClientTest с MockRestServiceServer для исходящих запросов, при миграции используйте RestClient.Builder. Примечания к миграции HTTP-клиентов.
Почему тот же JAR быстрее стартует
Тут надо делать шаг назид и сказать, как устроен обычный executable JAR от Boot, т.к. не все знают.
По дефолту, ваши классы лежат в BOOT-INF/classes, зависимости лежат отдельными JAR-ами в BOOT-INF/lib. Launcher должен уметь искать классы и ресурсы внутри этих вложенных архивов (по сути там свой ClassLoader кастомный используется).
Так вот раньше при таком поиске открывался URL connection для каждого проверяемого вложенного JAR-а. В 4.2 поиск идёт напрямую по вложенным архивам. Плюс оптимизировали чтение сжатых записей и разрешение закэшированных ресурсов. Меньше работы и аллокаций на старте.
Отдельно ускорили сортировку автоконфигураций и рестарты DevTools (на продакшен это не повлияет, но локальная разработка будет пошустрее). Изменения в производительности старта.
Если хотите понять эффект у себя, сравните два собранных JAR-а через java -jar на одной JVM и с одним профилем. Запуск из IDE обычно кладёт зависимости прямо в classpath, так что интересующий нас путь через вложенные JAR-ы там можно просто обойти.
RabbitMQ. Как один стартер стал тремя
Вообще, первое, что вы должны помнить при обновлении Boot-а (да и модулей Spring Framework), так это то, что минорный релиз может и часто будет нести ломающие изменения. Я об этом писал подробно вот в этой статье. Есть конкретные причины такого поведения, так делает ряд крупных и известных вам проектов, от Axelix до K8S - все они могут в minor релизе вас сломать.
Когда я писал про модуляризацию в Boot 4, речь шла о довольно простой идее. По зависимости должно быть понятно, какую конкретно автоконфигурацию вы тащите в приложение.
С AMQP долгое время всё было просто. Подключили spring-boot-starter-amqp, получили поддержку RabbitMQ через AMQP 0-9-1. Теперь Boot умеет ещё и AMQP 1.0. И тут цифры немного сбивают с толку. 1.0 выглядит как следующая версия того же протокола, на которую клиент переедет сам собой. На практике у этих вариантов разные модели обмена сообщениями и разные клиенты. У RabbitMQ при этом есть поддержка обоих вариантов.
Вот во что это вылилось в Boot 4.2.
Что вы хотите использовать | Какой стартер подключать |
|---|---|
Привычный RabbitMQ с AMQP 0-9-1 |
|
AMQP 1.0 с возможностями, специфичными для RabbitMQ |
|
AMQP 1.0 для брокера с поддержкой этого протокола, через Qpid ProtonJ2 |
|
Если задача звучит как «обновить Boot, оставить нашу работу с RabbitMQ как есть», вам нужна первая строка. Конфигурация spring.rabbitmq.* остаётся прежней. А вот если вы импортировали классы автоконфигурации Boot, например в собственном стартере, проверьте импорты. Модуль spring-boot-amqp для старой RabbitMQ-интеграции переехал в spring-boot-rabbitmq, а её классы переехали из org.springframework.boot.amqp в org.springframework.boot.rabbitmq. Проверьте и тестовые зависимости, потому что spring-boot-starter-amqp-test теперь тоже относится к AMQP 1.0. Подробности миграции AMQP.
А если вы сознательно идёте на RabbitMQ с AMQP 1.0, там уже свой namespace spring.amqp.rabbitmq.* и свой health indicator amqprabbit. И ещё одна мелочь, на которую легко попасться локально. Без явно заданных логина и пароля клиент пытается подключиться анонимно. Настройки AMQP 1.0.
OpenTelemetry. Куда отправляем и под какими именами
В Boot 4.2 появились две настройки, которые легко мысленно склеить в одну. Начнём с транспорта. Если метрики, логи и трейсы уже уходят по OTLP в один Collector, общий адрес теперь можно задать один раз.
management:
opentelemetry:
otlp:
endpoint: http://otel-collector:4318
Для HTTP Boot сам добавит путь соответствующего сигнала, например /v1/traces. Endpoint, заданный непосредственно для сигнала, имеет приоритет. С заголовками чуть интереснее. Общие и специфичные для сигнала заголовки объединяются, и при совпадении ключа выигрывает настройка сигнала. Сама общая настройка используется как fallback для настроенных экспортёров. Общая конфигурация OTLP.
Теперь представьте, что Collector получает данные и от Java-сервисов на Spring, и от сервисов на других стеках. Хочется, чтобы один и тот же HTTP-запрос был описан в телеметрии по одним правилам. Для этого в Boot появился opt-in management.observations.conventions=open-telemetry. Поддерживаются стабильные semantic conventions OpenTelemetry.
На практике я бы сначала открыл запросы, на которых живут дашборды и алерты. Если они ссылаются на старые имена метрик или атрибутов, их, возможно, придётся переписать. К примеру, при выборе OpenTelemetry conventions настройка management.observations.http.server.requests.name перестаёт влиять на имя метрики. Так что общий endpoint я бы включил одним PR-ом, а смену conventions, вместе с изменениями запросов в мониторинге, другим. Semantic conventions в Boot 4.2.
Forwarded headers. Локально-то всё работает
Допустим, сервис доступен снаружи под https://example.org/billing. Прокси снимает /billing перед тем, как отправить запрос в приложение, и передаёт этот префикс в X-Forwarded-Prefix. Само приложение обрабатывает условный /orders, но когда оно строит абсолютную ссылку на заказ, снаружи нужен адрес с /billing/orders.
И вот этот X-Forwarded-Prefix в Boot 4.2 по умолчанию игнорируется. Ваш тест напрямую ходит в приложение, получает свои 200, и всё прекрасно. А пользователь за реальным прокси получает ссылку без /billing.
Если от префикса действительно зависит приложение, для Tomcat можно настроить это так.
server:
request:
header:
forwarded:
strategy: framework
use-prefix: true
Заодно здесь виден новый namespace. Свойство server.forward-headers-strategy задепрекейтили в пользу server.request.header.forwarded.strategy. Значение native в новой настройке называется web-server. Оставите в конфигурации оба свойства, приложение упадёт при старте. В режиме web-server Tomcat и Jetty не умеют применять use-prefix, поэтому в примере выбран framework.
Ещё один момент. Spring Framework 7.1 требует выбрать семейство заголовков. Boot по умолчанию использует X-Forwarded-*. Если прокси у вас выставляет стандартный Forwarded, выберите server.request.header.forwarded.naming=rfc-7239. Проверять я бы это пошёл прямо через ingress, на каком-нибудь redirect-е и на ссылке, которую генерирует само приложение. Документация по работе за прокси.
Buildpacks. Кэш теперь переживает CI runner
Я почти на 100% уверен, что пользователей каких-либо buildpack-ов среди читателей будет мало, но я всё же скажу пару слов и про них.
Часто в CI под каждую сборку поднимается новый runner (речь не про slave ноду для выполнения). Локальные Docker volume-ы прекрасно работают, пока следующая сборка находит тот же volume. Если runner одноразовый, следующий запуск начинает с холодного кэша.
В Boot 4.2 buildCache можно хранить в container registry как образ. Один runner публикует слои кэша, следующий их оттуда забирает. Поддержка есть и в Maven, и в Gradle. У buildWorkspace и launchCache по-прежнему только локальные варианты. Кэш Buildpacks в registry.
А вот два изменения, которые затронут и тех, кто никакой новый кэш настраивать не собирался.
По умолчанию builder теперь
paketobuildpacks/ubuntu-resolute-builder. Базовая Ubuntu в образах переезжает с 24.04 на 26.04. Если вам важна воспроизводимость, отдельно закрепите версииbuilderиrunImage.У Paketo есть интеграция со Spring Cloud Bindings, которую buildpack подключает автоматически. На момент релиза она может сломать запуск уже собранного образа с Boot 4.2. Причина вполне конкретная. Bindings ищет
EnvironmentPostProcessorв старом пакете. В release notes предлагают выставитьBP_SPRING_CLOUD_BINDINGS_DISABLED=trueна этапе сборки образа, пока совместимость не поправят. Если приложение рассчитывает на bindings, просто отключить их и считать миграцию законченной не получится. Изменения Buildpacks при обновлении.
Что реально может сломаться при переходе с 4.1 на 4.2
Если бы я ревьюил PR, в котором просто подняли версию Boot, я бы сначала посмотрел на эти три места.
RabbitMQ. Если в проекте остался
spring-boot-starter-amqp, Boot больше не подтянет через него прежнюю автоконфигурацию RabbitMQ. В типичном приложении, где она создаётRabbitTemplate, можно получить ошибку при старте из-за отсутствующего бина. Если проект напрямую использует классы, которые раньше приходили транзитивно, может упасть уже компиляция. Для AMQP 0-9-1 замените стартер наspring-boot-starter-rabbitmq. Миграция AMQP.Приложение за прокси. Если ingress передаёт внешний префикс через
X-Forwarded-Prefix, после обновления сервис может спокойно стартовать, но генерировать ссылки и перенаправления без этого префикса. Проверьте реальныйLocationчерез ingress. Если приложению нужен префикс, включитеuse-prefix. Для Tomcat и Jetty используйте стратегиюframework. Отдельно проверьте настройки из переменных окружения. Если остались сразу старый и новый ключи стратегии, сервис упадёт при старте. Изменения forwarded headers.Образ, собранный Paketo. Maven или Gradle могут успешно собрать образ, который потом упадёт при запуске из-за несовместимых Spring Cloud Bindings. Поэтому в CI я бы запустил именно собранный образ и дождался ответа health endpoint. Если релизная несовместимость воспроизводится и приложение не использует bindings, выставьте
BP_SPRING_CLOUD_BINDINGS_DISABLED=trueпри сборке. Совместимость со Spring Cloud Bindings.
Есть ещё несколько изменений, где всё зависит от того, какие настройки у вас уже есть.
WebFlux и загрузка файлов. Запрос с 51 частью теперь отклоняется по умолчанию. То же самое произойдёт, если для одной части потребуется больше 1 МБ на диске. Раньше оба лимита были неограниченными. Если у вас есть загрузка файлов на WebFlux, прогоните типичный большой запрос и при необходимости поднимите
spring.webflux.multipart.max-partsиspring.webflux.multipart.max-disk-usage-per-part. Лимиты multipart.Redis master/replica. При заданных
spring.data.redis.masterreplica.nodesраньше всегда использовалась база 0, даже если в настройках или URL была указана другая база. Теперь приложение действительно начнёт читать и писать в указанную базу. Если после выкладки привычные ключи внезапно «пропали», проверьте номер базы. Чтобы сохранить прежнее поведение, укажите 0 или уберите номер из настроек подключения. Изменения Redis.Tomcat и редиректы.
server.tomcat.servlet.use-relative-redirectsтеперь по умолчаниюtrue. Если клиент или тест ожидает абсолютный URL вLocation, проверьте ответ после обновления. Прежнее поведение можно вернуть значениемfalse. Настройки Tomcat.Micrometer. Если дашборд показывает длительность операций, которые ещё выполняются, проверьте его после обновления. Boot перестал по умолчанию создавать
LongTaskTimerдля активных observations. Прежнее поведение возвращается черезmanagement.metrics.observations.include-active-long-task-timer=true. Изменения Micrometer.Старые deprecation-ы. API и свойства, задепрекейченные ещё в Boot 4.0, в 4.2 удалены. Это уже повод проверить компиляцию и настройки окружений. Если вы используете
spring-boot-properties-migrator, теперь его можно настроить так, чтобы приложение падало при обнаружении ошибок или предупреждений. Список изменений при переходе с 4.1.
Кстати, ещё два пункта из release notes. У встроенного LDAP включение SSL без bundle теперь приводит к ошибке запуска. А стартер Apache Pulsar пока deprecated, как и поддержка RestTemplate. Для Pulsar есть гайд по переходу на стартер нового проекта.
Сам Boot перешёл, среди прочего, на Spring Framework 7.1.0, Spring Security 7.2.0, Spring Data 2026.1.0 и Micrometer 1.18.0. Если у вас в сборке закреплены собственные версии этих библиотек, сравните их с тем, что теперь управляется BOM-ом Boot. Обновлённые зависимости.
Что в итоге?
По мне, у 4.2 довольно характерный набор изменений. Из нового можно взять общий OTLP endpoint, ускорение старта получить вместе с обновлением, а миграцию на RestClient спокойно делать по одному клиенту. Но в самом PR-е с обновлением версии я бы в первую очередь проверил то, что уже работает в проде: какую автоконфигурацию приносит AMQP-стартер, куда ведёт redirect за прокси и стартует ли образ, который собрал CI. Для каждого из этих трёх сценариев зелёный локальный тест может вообще ничего не сказать.
KioskNews shows a cleaned-up reading view extracted from the publisher’s page — the original always lives on their site, not ours.