Spring Boot DevTools у 2026: hot reload, LiveReload і продуктивність розробника

Spring Boot DevTools на практиці: як працює hot reload через перезапуск, властивості spring.devtools, застарілий LiveReload у 4.1, ClassCastException і @RestartScope з Testcontainers.

Spring Boot DevTools: hot reload і перезапуск Java-застосунку

Цикл «редагування, збирання, перезапуск» у вебзастосунку на Java може забирати понад десять секунд після кожної дрібної правки. Spring Boot DevTools скорочує його до однієї-двох секунд, оскільки перезавантажує лише код проєкту, а не весь застосунок. Модуль постачається з кожним релізом Spring Boot, і в гілці 4.1 (поточна стабільна версія 4.1.2) автоматичний перезапуск залишається його головною функцією для продуктивності розробника. Натомість LiveReload, друга відома можливість модуля, тепер позначена як застаріла.

Spring Boot DevTools в одному абзаці

DevTools розділяє classpath на два завантажувачі класів: базовий, що містить сторонні jar-файли, і перезапускний (restart classloader), у якому живуть класи проєкту. Коли скомпільований клас змінюється, відкидається та створюється наново лише другий, тому перезапуск відбувається значно швидше за холодний старт. Крім того, DevTools вимикає кешування шаблонів і автоматично деактивується в застосунку, запущеному як упакований java -jar.

Підключення залежності spring-boot-devtools

DevTools складається з одного артефакту. Ключову роль відіграє його область видимості: залежність ніколи не повинна потрапити в інші модулі чи у продакшн-архів. Maven виражає це через optional, Gradle через конфігурацію developmentOnly, яку надає плагін Spring Boot.

xml
<!-- pom.xml -->
<dependencies>
    <!-- Version is managed by spring-boot-starter-parent 4.1.x -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-devtools</artifactId>
        <!-- optional: not propagated to modules that depend on this one -->
        <optional>true</optional>
    </dependency>
</dependencies>

Еквівалент для Gradle вміщується в один рядок:

build.gradle.ktskotlin
dependencies {
    // developmentOnly: on the classpath for bootRun, absent from bootJar
    developmentOnly("org.springframework.boot:spring-boot-devtools")
}

Плагіни Maven і Gradle за замовчуванням виключають DevTools із перепакованого jar. Понад те, DevTools розпізнає запуск «повністю упакованого» застосунку (java -jar або власний завантажувач класів лаунчера) і вимикає себе, оскільки офіційна документація DevTools вважає будь-який такий запуск продакшном. Примусово ввімкнути модуль через -Dspring.devtools.restart.enabled=true технічно можливо, і саме цього продакшн-розгортання має уникати.

Як насправді працює hot reload у Spring Boot

Вислів «hot reload у Spring Boot» трохи вводить в оману. DevTools не підмінює байткод усередині працюючої JVM: він виконує перезапуск, але дуже дешевий.

МеханізмЩо змінюється без перезапускуВартість однієї зміниІнструмент
JVM HotSwap (налагоджувач)Лише тіла методівМайже нульоваНалагоджувач будь-якої IDE
Перезапуск DevToolsБудь-який клас, бін, конфігураціяЗазвичай від 1 до 3 секундspring-boot-devtools
Повний перезапускУсеПовний час стартуНемає
Агенти перезавантаженняБільшість змін структури класівМайже нульоваJRebel та подібні

Швидкість перезапуску забезпечує саме архітектура з двома завантажувачами класів. Бібліотеки з Maven Central протягом сесії майже не змінюються, тому залишаються завантаженими в базовому classloader разом з усією роботою, яку над ними вже виконав JIT-компілятор. Класи проєкту з каталогу target/classes або build/classes живуть у перезапускному classloader. Зміна призводить до того, що цей завантажувач відкидається, створюється новий, а ApplicationContext будується з нуля.

На практиці з цього випливають два важливі наслідки:

  • Стан втрачається. Кеші в пам'яті, сесії, що зберігаються в пам'яті, та прогрес запланованих задач зникають під час кожного перезапуску. Так задумано: контекст створюється наново.
  • Перезапуск ініціює classpath, а не редактор. DevTools стежить за скомпільованими файлами. Збереження .java-файлу нічого не дає, доки IDE або інструмент збирання його не скомпілює.

Другий пункт пояснює більшість скарг на кшталт «DevTools не працює». В IntelliJ IDEA проєкт потрібно зібрати (Ctrl+F9 / Cmd+F9) або ввімкнути опцію «Build project automatically» разом із розширеним налаштуванням, що дозволяє автоматичну компіляцію під час роботи застосунку. Документація IntelliJ IDEA щодо Spring Boot описує параметри конфігурації запуску («On update action», «On frame deactivation»), які запускають цей крок компіляції. Eclipse і Spring Tools компілюють під час збереження, тому перезапуск відбувається без додаткового налаштування.

Налаштування автоматичного перезапуску через властивості spring.devtools

DevTools конфігурується властивостями spring.devtools.*. Значення за замовчуванням у Spring Boot 4.1.2 варто знати, адже вони пояснюють кілька неочевидних моментів у поведінці: спостерігач за файлами перевіряє зміни кожну 1 секунду і чекає 400 мс тиші перед перезапуском. Завдяки цьому компіляція кількох файлів дає один перезапуск, а не п'ять.

Наведена нижче конфігурація адаптує DevTools до проєкту, який компілюється повільно (великий багатомодульний білд, мережевий диск, том Docker) і віддає статичні ресурси з каталогу, що формується збиранням фронтенду.

properties
# src/main/resources/application-dev.properties
# Watch less often and wait longer before restarting: avoids double restarts on slow compiles
spring.devtools.restart.poll-interval=2s
spring.devtools.restart.quiet-period=1s

# Keep the default exclusions (static/**, templates/**...) and add one more folder
spring.devtools.restart.additional-exclude=generated/**

# Watch a folder outside the classpath (shared contract files, for example)
spring.devtools.restart.additional-paths=../shared-contracts/src/main/resources

# Restart only when this file is touched, not on every compile
spring.devtools.restart.trigger-file=.reloadtrigger

# Keep the condition evaluation delta report short on each restart
spring.devtools.restart.log-condition-evaluation-delta=false

Роботу цих властивостей визначають кілька правил:

  • spring.devtools.restart.exclude замінює список за замовчуванням (META-INF/maven/**, META-INF/resources/**, resources/**, static/**, public/**, templates/**, тестові класи та файли build info). additional-exclude доповнює його, і майже завжди потрібне саме це.
  • Виключені ресурси не викликають перезапуску, але все одно віддаються в актуальному вигляді, бо DevTools вимикає кеші на зразок spring.thymeleaf.cache і встановлює spring.web.resources.cache.period у 0.
  • Тригер-файл має лежати в classpath (src/main/resources/.reloadtrigger). IntelliJ IDEA Ultimate і Spring Tools уміють оновлювати його після збирання.
  • spring.devtools.restart.enabled=false в application.properties зупиняє спостереження за файлами, однак перезапускний classloader усе одно ініціалізується. Щоб повністю вимкнути DevTools, системну властивість потрібно встановити в методі main до виклику SpringApplication.run.

Налаштування, що діють для всіх проєктів на машині, DevTools читає з глобального файлу в каталозі $HOME/.config/spring-boot/ з назвою spring-boot-devtools.properties (або .yaml / .yml). Саме тут доречно задавати персональний тригер-файл, який не повинен потрапляти до командного репозиторію. Профілі в цьому файлі не підтримуються.

Готовий до співбесід з Spring Boot?

Практикуйся з нашими інтерактивними симуляторами, flashcards та технічними тестами.

LiveReload у Spring Boot: застарілий з версії 4.1

LiveReload автоматично оновлює сторінку в браузері, коли змінюється ресурс. DevTools містить вбудований LiveReload-сумісний сервер на порту 35729, до якого підключається розширення браузера. У Spring Boot 4.1 сервер вимкнений за замовчуванням, і його потрібно явно активувати:

properties
# application-dev.properties
# Deprecated since Spring Boot 4.1.0, no replacement planned
spring.devtools.livereload.enabled=true
spring.devtools.livereload.port=35729

Примітки до релізу Spring Boot 4.1 кажуть про це прямо: через зниження популярності та підтримки функцію LiveReload у DevTools позначено як застарілу без запланованої заміни. Браузерні розширення майже не підтримуються, а більшість фронтендів у 2026 році збирається за допомогою Vite або іншого dev-сервера, що вже надає hot module replacement.

Не варто будувати новий робочий процес на LiveReload

Наявні проєкти на Thymeleaf поки що можуть залишити spring.devtools.livereload.enabled=true, проте застаріла властивість у Spring Boot є кандидатом на видалення в одній із наступних мажорних версій. Для шаблонів, що рендеряться на сервері, налаштування кешу, які застосовує DevTools, і так дозволяють побачити останню версію шаблону після звичайного ручного оновлення сторінки, без перезапуску застосунку.

Пастки перезапускного classloader і ClassCastException

Найпоширеніша помилка DevTools виглядає абсурдно: com.example.Order cannot be cast to com.example.Order. Імена класів однакові, бо обидва класи походять із двох різних завантажувачів. Один Order завантажив перезапускний classloader, інший базовий (або попередній перезапускний, який мав би бути відкинутий).

Зазвичай це стається в трьох ситуаціях:

  1. Бібліотека десеріалізує об'єкти стандартним ObjectInputStream, який шукає класи через неправильний завантажувач. Так поводяться реплікація сесій і деякі кеші.
  2. Модуль проєкту підключається як jar (наприклад, бібліотека common у багатомодульному білді) і опиняється в базовому classloader, тоді як класи, що на нього посилаються, перебувають у перезапускному.
  3. Статичне поле утримує екземпляр, створений до останнього перезапуску.

Для другого випадку DevTools читає з classpath файл META-INF/spring-devtools.properties. Його ключі переміщують jar-файли між двома завантажувачами за допомогою регулярних виразів:

properties
# src/main/resources/META-INF/spring-devtools.properties
# Load the team's shared domain jar in the restart classloader, so it restarts with the app
restart.include.shared-domain=/orders-shared-domain-[\\w\\d.-]+\\.jar

# Keep a heavy internal SDK in the base classloader, it never changes during development
restart.exclude.payments-sdk=/payments-sdk-[\\w\\d.-]+\\.jar

Ключі мають бути лише унікальними, значення має префікс restart.include. або restart.exclude.. У першому випадку рішення полягає в десеріалізації через спрінговий ConfigurableObjectInputStream з передаванням Thread.currentThread().getContextClassLoader(), що вказує на поточний перезапускний завантажувач.

Якщо перезапуски все ще надто повільні або проблеми із завантажувачами класів не вдається усунути, задокументованою альтернативою є агент перезавантаження на кшталт JRebel, який перевизначає класи на місці замість перезапуску контексту.

DevTools разом із Testcontainers і @RestartScope

Починаючи зі Spring Boot 3.1, проєкт може піднімати бази даних і брокери повідомлень через Testcontainers і під час розробки, використовуючи клас запуску в src/test/java. Наївні перезапуски погано з цим поєднуються: кожен перезапуск знищував би та створював наново контейнер PostgreSQL, що коштує кількох секунд і стирає дані.

Анотація @RestartScope з модуля DevTools розв'язує саме цю проблему. Бін, позначений нею, переживає перезапуски DevTools. Конфігурація нижче відповідає посібнику Spring Boot щодо сервісів часу розробки і використовує назви пакетів Testcontainers 2, на який спирається Spring Boot 4.

src/test/java/com/example/orders/DevContainersConfiguration.javajava
package com.example.orders;

import org.springframework.boot.devtools.restart.RestartScope;
import org.springframework.boot.test.context.TestConfiguration;
import org.springframework.boot.testcontainers.service.connection.ServiceConnection;
import org.springframework.context.annotation.Bean;
import org.testcontainers.postgresql.PostgreSQLContainer;

@TestConfiguration(proxyBeanMethods = false)
public class DevContainersConfiguration {

    @Bean
    @RestartScope        // the container is kept across DevTools restarts
    @ServiceConnection   // datasource URL, user and password wired automatically
    PostgreSQLContainer postgres() {
        return new PostgreSQLContainer("postgres:17-alpine");
    }
}

Клас запуску повторно використовує справжній метод main і додає конфігурацію:

src/test/java/com/example/orders/TestOrdersApplication.javajava
package com.example.orders;

import org.springframework.boot.SpringApplication;

public class TestOrdersApplication {

    public static void main(String[] args) {
        // Starts OrdersApplication with the containers declared above
        SpringApplication.from(OrdersApplication::main)
                .with(DevContainersConfiguration.class)
                .run(args);
    }
}

Застосунок запускається командою ./mvnw spring-boot:test-run або ./gradlew bootTestRun. Одна деталь у Gradle непомітно ламає цю схему: з developmentOnly DevTools відсутній у classpath задачі bootTestRun, тож зміни в коді ігноруються. Залежність потрібно перенести в testAndDevelopmentOnly("org.springframework.boot:spring-boot-devtools"). Частину, що стосується інтеграційних тестів, розглянуто в посібнику з Testcontainers для Spring Boot.

Віддалений DevTools і чому продакшн залишається під забороною

DevTools також уміє надсилати зміни в застосунок, що працює деінде, наприклад у контейнері на спільному сервері для розробки. Серверна частина активується лише тоді, коли задано spring.devtools.remote.secret і DevTools явно включено в архів (excludeDevtools=false у плагіні Maven). Клієнтом виступає org.springframework.boot.devtools.RemoteSpringApplication, який запускається з IDE з адресою віддаленого застосунку як аргументом.

Документація однозначно окреслює межі: віддалений DevTools можна запускати лише в довіреній мережі або через HTTPS, ніколи в продакшні, і він не підтримує застосунки на Spring WebFlux. Ендпоінт, який приймає файли класів і перезапускає застосунок, за своєю природою є каналом віддаленого виконання коду. У більшості конфігурацій 2026 року локальний запуск застосунку із сервісами Testcontainers або Docker Compose дає швидший цикл без жодного з цих ризиків.

Питання про Spring Boot DevTools на співбесіді

На співбесідах зі Spring Boot тема DevTools слугує приводом поговорити про глибше питання: завантаження класів і життєвий цикл контексту застосунку. Найчастіші запитання та відповіді, яких очікують від досвідченого розробника:

  • «DevTools виконує hot swap чи перезапуск?» Перезапуск. Він відкидає перезапускний classloader і перебудовує ApplicationContext, а JVM і базовий завантажувач продовжують працювати. Відповідь «hot swap» є класичною помилкою junior-розробника.
  • «Чому DevTools безпечно залишати в pom?» Три рівні захисту: область optional або developmentOnly, виключення з перепакованого jar і автоматична деактивація під час java -jar. Сильна відповідь згадує, що примусове spring.devtools.restart.enabled=true обходить третій рівень.
  • «Звідки береться X cannot be cast to X?» Від двох завантажувачів, які завантажили той самий клас. Виправляється через META-INF/spring-devtools.properties або контекстний classloader потоку.
  • «Що відбувається з кешем у пам'яті під час перезапуску?» Він зникає, якщо бін не має області @RestartScope.

Ці питання перетинаються з темами конфігурації, тому модуль питань для співбесіди про Spring Boot DevTools добре поєднується з модулем про профілі та оточення: саме профіль dev є природним місцем для більшості описаних властивостей. Повна база запитань доступна на сторінці технології Spring Boot.

Чекліст налаштування Spring Boot DevTools на 2026 рік

  • Оголосити spring-boot-devtools як optional (Maven) або developmentOnly (Gradle), а для запуску класу Testcontainers через bootTestRun перейти на testAndDevelopmentOnly.
  • Переконатися, що IDE компілює під час збереження або втрати фокусу вікном: DevTools стежить за скомпільованими класами, а не за вихідними файлами.
  • Використовувати spring.devtools.restart.additional-exclude замість exclude, щоб зберегти стандартні виключення статичних ресурсів і шаблонів.
  • Задати тригер-файл у глобальному ~/.config/spring-boot/spring-boot-devtools.properties, якщо постійні перезапуски заважають під час рефакторингу.
  • Вважати LiveReload застарілим зі Spring Boot 4.1.0 і покладатися натомість на dev-сервер фронтенду або ручне оновлення сторінки.
  • Позначати контейнери для розробки анотацією @RestartScope, щоб PostgreSQL чи Kafka переживали кожен перезапуск.
  • Діагностувати X cannot be cast to X як розщеплення завантажувачів класів і виправляти його записами restart.include.

Починай практикувати!

Перевір свої знання з нашими симуляторами співбесід та технічними тестами.

Щоденний виклик

Чи знайдеш ти помилку в Spring Boot?

Справжній фрагмент коду, прихована помилка, одна спроба на день. Щоб спробувати, акаунт не потрібен.

Anthony Fillion-Maillet

Автор:

Anthony Fillion-Maillet

Засновник SharpSkill

Fullstack-розробник понад 10 років. Керує SharpSkill і відповідає за все, що тут публікується.

Оновлено 12 листопада 2026 р.

Теги

#spring boot devtools
#hot reload
#livereload
#продуктивність розробника
#testcontainers

Поділитися

Пов'язані статті