# Spring Boot DevTools у 2026: hot reload, LiveReload і продуктивність розробника > Spring Boot DevTools на практиці: як працює hot reload через перезапуск, властивості spring.devtools, застарілий LiveReload у 4.1, ClassCastException і @RestartScope з Testcontainers. - Published: 2026-11-12 - Updated: 2026-11-12 - Author: Anthony Fillion-Maillet - Tags: spring boot devtools, hot reload, livereload, продуктивність розробника, testcontainers - Reading time: 11 min --- Цикл «редагування, збирання, перезапуск» у вебзастосунку на 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 org.springframework.boot spring-boot-devtools true ``` Еквівалент для Gradle вміщується в один рядок: ```kotlin // build.gradle.kts 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](https://docs.spring.io/spring-boot/reference/using/devtools.html) вважає будь-який такий запуск продакшном. Примусово ввімкнути модуль через `-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](https://www.jetbrains.com/help/idea/spring-boot.html) описує параметри конфігурації запуску («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`). Саме тут доречно задавати персональний тригер-файл, який не повинен потрапляти до командного репозиторію. Профілі в цьому файлі не підтримуються. ## 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](https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-4.1-Release-Notes) кажуть про це прямо: через зниження популярності та підтримки функцію 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 щодо сервісів часу розробки](https://docs.spring.io/spring-boot/reference/features/dev-services.html) і використовує назви пакетів Testcontainers 2, на який спирається Spring Boot 4. ```java // src/test/java/com/example/orders/DevContainersConfiguration.java 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` і додає конфігурацію: ```java // src/test/java/com/example/orders/TestOrdersApplication.java 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](https://sharpskill.dev/uk/blog/spring-boot/testcontainers-spring-boot-integration-testing). ## Віддалений 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](https://sharpskill.dev/uk/technologies/spring-boot/pytannia-spivbesidy/spring-boot-devtools) добре поєднується з [модулем про профілі та оточення](https://sharpskill.dev/uk/technologies/spring-boot/pytannia-spivbesidy/profiles-environment): саме профіль `dev` є природним місцем для більшості описаних властивостей. Повна база запитань доступна на [сторінці технології Spring Boot](https://sharpskill.dev/uk/technologies/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`. --- Source: SharpSkill (https://sharpskill.dev), tech interview preparation for your real stack. HTML version of this page: https://sharpskill.dev/uk/blog/spring-boot/spring-boot-devtools-hot-reload-livereload