Spring Boot DevTools 완벽 가이드 2026: 핫 리로드, LiveReload, 개발 생산성
Spring Boot 4.1 기준 Spring Boot DevTools 튜토리얼. 자동 재시작 원리, spring.devtools 속성 튜닝, 지원 중단된 LiveReload, ClassCastException 원인, Testcontainers와 @RestartScope 활용법을 정리합니다.

Spring Boot로 웹 애플리케이션을 개발할 때 가장 많은 시간을 잡아먹는 작업 중 하나는 코드 수정, 빌드, 재시작으로 이어지는 반복 루프입니다. Spring Boot DevTools는 변경된 프로젝트 클래스만 다시 로드하는 방식으로 이 루프를 1~2초 수준으로 줄여 줍니다. 2026년 11월 기준 안정 버전인 Spring Boot 4.1(작성 시점 4.1.2)에서도 자동 재시작은 DevTools의 핵심 기능이지만, 브라우저를 자동으로 새로 고치는 LiveReload는 지원 중단(deprecated) 상태가 되었습니다. 이 글에서는 의존성 선언 방법부터 재시작 원리, 속성 튜닝, 클래스로더 문제, Testcontainers 연동까지 실무에 필요한 내용을 단계별로 정리합니다.
Spring Boot DevTools는 클래스패스를 두 개의 클래스로더로 나눕니다. 서드파티 jar를 담당하는 베이스 클래스로더와 프로젝트 클래스를 담당하는 리스타트 클래스로더입니다. 컴파일된 클래스가 바뀌면 리스타트 클래스로더만 폐기하고 새로 만들기 때문에, 콜드 스타트보다 훨씬 빠르게 재시작됩니다. 또한 DevTools는 템플릿 캐시를 비활성화하며, java -jar로 실행되는 패키징된 애플리케이션에서는 스스로 꺼집니다.
spring-boot-devtools 의존성 추가하기
DevTools는 단일 아티팩트로 제공됩니다. 핵심은 스코프입니다. 이 의존성이 다른 모듈이나 운영용 아카이브로 새어 나가서는 안 됩니다. Maven에서는 optional로, Gradle에서는 Spring Boot 플러그인이 제공하는 developmentOnly 구성으로 이를 표현합니다.
<!-- 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에서는 한 줄이면 충분합니다.
dependencies {
// developmentOnly: on the classpath for bootRun, absent from bootJar
developmentOnly("org.springframework.boot:spring-boot-devtools")
}Maven 플러그인과 Gradle 플러그인 모두 기본적으로 리패키징된 jar에서 DevTools를 제외합니다. 여기에 더해 DevTools는 "완전히 패키징된" 실행(java -jar 또는 커스텀 런처 클래스로더)을 감지하면 스스로 비활성화됩니다. DevTools 공식 레퍼런스가 이러한 실행 방식을 운영 환경으로 간주하기 때문입니다. -Dspring.devtools.restart.enabled=true로 강제 활성화할 수는 있지만, 운영 배포에서는 반드시 피해야 하는 설정입니다.
Spring Boot 핫 리로드의 실제 동작 원리
"Spring Boot 핫 리로드"라는 표현은 사실 조금 오해의 소지가 있습니다. DevTools는 실행 중인 JVM 내부에서 바이트코드를 교체하지 않습니다. 실제로는 재시작을 수행하며, 다만 그 비용이 매우 낮을 뿐입니다.
| 방식 | 재시작 없이 반영되는 범위 | 변경당 비용 | 도구 |
|---|---|---|---|
| JVM HotSwap(디버거) | 메서드 본문만 | 거의 0 | 모든 IDE 디버거 |
| DevTools 재시작 | 모든 클래스, 빈, 설정 | 보통 1~3초 | spring-boot-devtools |
| 전체 재시작 | 전부 | 전체 기동 시간 | 없음 |
| 리로딩 에이전트 | 대부분의 클래스 구조 변경 | 거의 0 | JRebel 등 |
재시작을 빠르게 만드는 것은 두 개의 클래스로더 설계입니다. Maven Central에서 가져온 jar는 개발 세션 동안 거의 바뀌지 않으므로, 이미 수행된 JIT 최적화와 함께 베이스 클래스로더에 그대로 남습니다. 반면 target/classes나 build/classes에 있는 프로젝트 클래스는 리스타트 클래스로더에 올라갑니다. 변경이 발생하면 이 로더가 폐기되고 새 로더가 생성되며, ApplicationContext가 처음부터 다시 구성됩니다.
실무에서는 두 가지 결과가 중요합니다.
- 상태가 사라집니다. 메모리 캐시, 인메모리 세션, 스케줄링 작업의 진행 상황은 재시작할 때마다 모두 초기화됩니다. 컨텍스트를 새로 만드는 구조이므로 의도된 동작입니다.
- 재시작은 에디터가 아니라 클래스패스가 트리거합니다. DevTools가 감시하는 대상은 컴파일 결과물입니다.
.java파일을 저장하는 것만으로는 IDE나 빌드 도구가 컴파일하기 전까지 아무 일도 일어나지 않습니다.
"DevTools가 동작하지 않는다"는 문의의 대부분은 두 번째 항목으로 설명됩니다. IntelliJ IDEA에서는 프로젝트를 빌드(Ctrl+F9 / Cmd+F9)하거나, "프로젝트 자동 빌드"를 켜고 애플리케이션 실행 중 자동 빌드를 허용하는 고급 설정까지 함께 활성화해야 합니다. 이 컴파일 단계를 실행하는 실행 구성 옵션("업데이트 시 동작", "프레임 비활성화 시")은 IntelliJ IDEA Spring Boot 문서에 정리되어 있습니다. Eclipse와 Spring Tools는 저장 시 컴파일하므로 별도 설정 없이 재시작이 일어납니다.
spring.devtools 속성으로 자동 재시작 튜닝하기
DevTools는 spring.devtools.* 속성으로 세부 동작을 조정할 수 있습니다. Spring Boot 4.1.2의 기본값을 알아 두면 몇 가지 의외의 동작이 이해됩니다. 파일 감시기는 1초마다 폴링하고, 재시작 전에 400밀리초의 대기(quiet period) 시간을 둡니다. 여러 파일을 컴파일해도 재시작이 다섯 번이 아니라 한 번만 일어나는 이유가 바로 이 대기 시간입니다.
아래 설정은 컴파일이 느린 프로젝트(대규모 멀티 모듈 빌드, 네트워크 드라이브, Docker 볼륨 등)에서 프런트엔드 빌드 폴더의 정적 자원을 서빙하는 상황에 맞춘 예시입니다.
# 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/**, 테스트 클래스, 빌드 정보 파일)을 대체합니다. 반면additional-exclude는 목록에 추가합니다. 대부분의 경우 의도하는 쪽은 후자입니다.- 제외된 리소스는 재시작을 유발하지 않지만 항상 최신 상태로 제공됩니다. DevTools가
spring.thymeleaf.cache같은 캐시를 끄고spring.web.resources.cache.period를 0으로 설정하기 때문입니다. - 트리거 파일은 클래스패스(
src/main/resources/.reloadtrigger)에 있어야 합니다. IntelliJ IDEA Ultimate와 Spring Tools는 빌드 후 이 파일을 갱신하는 기능을 제공합니다. application.properties에spring.devtools.restart.enabled=false를 지정하면 파일 감시는 멈추지만 리스타트 클래스로더는 여전히 초기화됩니다. DevTools를 완전히 끄려면SpringApplication.run호출 전에main메서드에서 시스템 속성을 설정해야 합니다.
한 대의 머신에 있는 모든 프로젝트에 적용할 설정은 $HOME/.config/spring-boot/ 아래의 전역 파일 spring-boot-devtools.properties(또는 .yaml / .yml)에 둘 수 있습니다. 팀 저장소에 커밋하지 않아야 할 개인용 트리거 파일 설정을 넣기에 적합한 위치입니다. 단, 이 파일에서는 프로파일이 지원되지 않습니다.
Spring Boot 면접 준비가 되셨나요?
인터랙티브 시뮬레이터, flashcards, 기술 테스트로 연습하세요.
Spring Boot LiveReload: 4.1에서 지원 중단
LiveReload는 리소스가 바뀌면 브라우저를 자동으로 새로 고치는 기능입니다. DevTools는 35729번 포트에서 LiveReload 호환 서버를 내장하고 있으며, 브라우저 확장 프로그램이 이 서버에 연결됩니다. Spring Boot 4.1에서는 이 서버가 기본적으로 꺼져 있어 명시적으로 켜야 합니다.
# application-dev.properties
# Deprecated since Spring Boot 4.1.0, no replacement planned
spring.devtools.livereload.enabled=true
spring.devtools.livereload.port=35729Spring Boot 4.1 릴리스 노트는 사용률과 지원이 줄어든 점을 이유로 DevTools의 LiveReload 기능을 대체 수단 없이 지원 중단한다고 명시하고 있습니다. 브라우저 확장 프로그램은 거의 관리되지 않고 있으며, 2026년의 프런트엔드 대부분은 핫 모듈 교체(HMR)를 기본 제공하는 Vite 같은 개발 서버로 구축됩니다.
기존 Thymeleaf 프로젝트는 당분간 spring.devtools.livereload.enabled=true를 유지할 수 있습니다. 하지만 Spring Boot에서 지원 중단된 속성은 이후 메이저 버전에서 제거될 수 있습니다. 서버 사이드 렌더링 템플릿의 경우 DevTools가 적용하는 캐시 설정 덕분에, 애플리케이션을 재시작하지 않고 브라우저를 수동으로 새로 고치기만 해도 최신 템플릿이 표시됩니다.
리스타트 클래스로더의 함정과 ClassCastException
DevTools에서 가장 흔한 버그는 언뜻 보면 말이 되지 않습니다. com.example.Order cannot be cast to com.example.Order처럼 두 클래스 이름이 완전히 같습니다. 이름이 같은데도 캐스팅에 실패하는 이유는 두 클래스가 서로 다른 클래스로더에서 왔기 때문입니다. 하나의 Order는 리스타트 클래스로더가, 다른 하나는 베이스 클래스로더(또는 이미 폐기되었어야 할 이전 리스타트 클래스로더)가 로드한 것입니다.
보통 다음 세 가지 상황에서 발생합니다.
- 라이브러리가 표준
ObjectInputStream으로 객체를 역직렬화하면서 잘못된 로더로 클래스를 찾는 경우입니다. 세션 복제나 일부 캐시가 이렇게 동작합니다. - 프로젝트 모듈이 jar 형태로 사용되어(멀티 모듈 빌드의
common라이브러리 등) 베이스 클래스로더에 올라가고, 이를 참조하는 클래스는 리스타트 클래스로더에 있는 경우입니다. - 마지막 재시작 이전에 생성된 인스턴스를 static 필드가 붙잡고 있는 경우입니다.
두 번째 경우를 위해 DevTools는 클래스패스의 META-INF/spring-devtools.properties 파일을 읽습니다. 이 파일의 키에 정규 표현식을 지정하면 jar를 두 클래스로더 사이에서 옮길 수 있습니다.
# 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. 접두사입니다. 첫 번째 경우는 Spring의 ConfigurableObjectInputStream으로 역직렬화하면서 현재 리스타트 로더를 가리키는 Thread.currentThread().getContextClassLoader()를 전달하면 해결됩니다.
그래도 재시작이 너무 느리거나 클래스로더 문제를 해결할 수 없다면, 문서가 안내하는 대안은 JRebel 같은 리로딩 에이전트입니다. 이 방식은 컨텍스트를 재시작하는 대신 클래스를 그 자리에서 재정의합니다.
DevTools와 Testcontainers, 그리고 @RestartScope
Spring Boot 3.1부터는 개발 단계에서 데이터베이스와 메시지 브로커를 Testcontainers로 띄울 수 있으며, 런처 클래스는 src/test/java에 둡니다. 문제는 단순한 재시작과의 궁합입니다. 재시작할 때마다 PostgreSQL 컨테이너가 삭제되고 다시 생성되어 몇 초가 낭비되고 데이터도 사라집니다.
DevTools 모듈에 포함된 @RestartScope가 바로 이 문제를 해결합니다. 이 애너테이션을 붙인 빈은 DevTools 재시작 이후에도 유지됩니다. 아래 구성은 Spring Boot 개발 시점 서비스 가이드를 따르며, Spring Boot 4가 사용하는 Testcontainers 2의 패키지명을 적용했습니다.
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 메서드를 재사용하고 위 설정을 추가합니다.
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가 bootTestRun의 클래스패스에 포함되지 않아 코드 변경이 무시됩니다. 의존성을 testAndDevelopmentOnly("org.springframework.boot:spring-boot-devtools")로 바꿔야 합니다. 이 구성의 통합 테스트 측면은 Testcontainers와 Spring Boot 가이드에서 자세히 다룹니다.
원격 DevTools와 운영 환경을 배제해야 하는 이유
DevTools는 다른 곳에서 실행 중인 애플리케이션, 예를 들어 공유 개발 서버의 컨테이너로 변경 사항을 전송할 수도 있습니다. 원격 서버 기능은 spring.devtools.remote.secret이 설정되어 있고 DevTools가 아카이브에 명시적으로 포함된 경우(Maven 플러그인의 excludeDevtools=false)에만 활성화됩니다. 클라이언트는 org.springframework.boot.devtools.RemoteSpringApplication이며, 원격 URL을 인자로 IDE에서 실행합니다.
허용 범위에 대한 문서의 입장은 분명합니다. 원격 DevTools는 신뢰할 수 있는 네트워크나 HTTPS에서만 사용해야 하고, 운영 환경에서는 절대 사용해서는 안 되며, Spring WebFlux 애플리케이션은 지원하지 않습니다. 클래스 파일을 받아 애플리케이션을 재시작하는 엔드포인트는 구조적으로 원격 코드 실행 통로가 될 수밖에 없습니다. 2026년의 대부분 환경에서는 Testcontainers나 Docker Compose 서비스를 대상으로 로컬에서 애플리케이션을 실행하는 편이 이러한 위험 없이 더 빠른 개발 루프를 제공합니다.
Spring Boot DevTools 면접 질문
Spring Boot 면접에서 DevTools는 더 깊은 주제, 즉 클래스 로딩과 애플리케이션 컨텍스트 생명주기를 확인하기 위한 소재로 등장합니다. 자주 나오는 질문과 경력 개발자에게 기대되는 답변은 다음과 같습니다.
- "DevTools는 핫 스와프인가요, 재시작인가요?" 재시작입니다. 리스타트 클래스로더를 폐기하고
ApplicationContext를 다시 구성하며, JVM과 베이스 클래스로더는 그대로 유지됩니다. "핫 스와프"라고 답하는 것은 주니어가 흔히 하는 실수입니다. - "DevTools를 pom에 남겨 두어도 안전한 이유는 무엇인가요?" 세 겹의 보호 장치가 있기 때문입니다.
optional또는developmentOnly스코프, 리패키징된 jar에서의 제외, 그리고java -jar실행 시 자동 비활성화입니다.spring.devtools.restart.enabled=true를 강제하면 세 번째 장치가 무력화된다는 점까지 언급하면 좋은 답변이 됩니다. - "
X cannot be cast to X는 왜 발생하나요?" 두 클래스로더가 같은 클래스를 로드했기 때문이며,META-INF/spring-devtools.properties나 컨텍스트 클래스로더로 해결합니다. - "재시작하면 인메모리 캐시는 어떻게 되나요?" 빈이
@RestartScope에 속하지 않는 한 사라집니다.
이 질문들은 설정 관련 주제와 겹치므로, Spring Boot DevTools 면접 질문 모듈과 프로파일 및 환경 모듈을 함께 학습하면 효과적입니다. 앞에서 다룬 속성 대부분은 dev 프로파일에 두는 것이 자연스럽기 때문입니다. 전체 질문 목록은 Spring Boot 기술 페이지에서 확인할 수 있습니다.
2026년 Spring Boot DevTools 설정 체크리스트
spring-boot-devtools는optional(Maven) 또는developmentOnly(Gradle)로 선언합니다. Testcontainers 런처를bootTestRun으로 실행한다면testAndDevelopmentOnly로 바꿉니다.- IDE가 저장 시 또는 프레임 비활성화 시 컴파일하도록 설정합니다. DevTools는 소스 파일이 아니라 컴파일된 클래스를 감시합니다.
- 기본 정적 자원 및 템플릿 제외 목록을 유지하려면
exclude대신spring.devtools.restart.additional-exclude를 사용합니다. - 리팩터링 중 잦은 재시작이 방해된다면 전역
~/.config/spring-boot/spring-boot-devtools.properties에 트리거 파일을 설정합니다. - LiveReload는 Spring Boot 4.1.0부터 지원 중단된 기능으로 보고, 프런트엔드 개발 서버나 수동 새로 고침을 활용합니다.
- 개발용 컨테이너에
@RestartScope를 붙여 PostgreSQL이나 Kafka가 재시작 후에도 유지되도록 합니다. X cannot be cast to X는 클래스로더 분리 문제로 진단하고restart.include항목으로 해결합니다.
마무리
Spring Boot DevTools는 마법 같은 핫 스와프가 아니라, 두 개의 클래스로더를 활용한 가벼운 재시작 메커니즘입니다. 이 전제를 이해하면 상태가 사라지는 이유, IDE의 컴파일 설정이 중요한 이유, 그리고 X cannot be cast to X 같은 난해한 오류의 원인까지 자연스럽게 설명할 수 있습니다. Spring Boot 4.1에서 LiveReload가 지원 중단되면서 개발 생산성의 중심은 자동 재시작과 @RestartScope 기반의 Testcontainers 개발 환경으로 옮겨 가고 있습니다. 의존성 스코프를 올바르게 지정하고 관련 속성을 dev 프로파일에 모아 두면, 운영 환경의 안전성을 해치지 않으면서도 빠른 개발 루프를 확보할 수 있습니다.
연습을 시작하세요!
면접 시뮬레이터와 기술 테스트로 지식을 테스트하세요.
Spring Boot 코드의 버그를 찾을 수 있나요
실제 코드 한 조각, 숨은 버그 하나, 하루 한 번. 계정 없이 바로 도전할 수 있습니다.

작성자
Anthony Fillion-MailletSharpSkill 창업자
10년 이상 풀스택 개발을 해왔습니다. SharpSkill을 운영하며 이곳에 게시되는 모든 내용에 책임을 집니다.
2026년 11월 12일 업데이트
태그
공유
관련 기사

Testcontainers Spring Boot: 고통 없는 통합 테스트
Spring Boot 3.4에서 Testcontainers를 구성하는 완전한 가이드입니다. 신뢰할 수 있고 재현 가능한 통합 테스트를 위해 Docker 컨테이너에서 PostgreSQL, Redis, Kafka를 실행합니다.

2026년 프리랜서 Java Spring Boot 개발자 일자리: 계약 찾기, 일당 단가, 면접 준비 방법
2026년 Spring Boot 프리랜서 계약 시장을 분석합니다. 유럽 전역의 일당 단가, 계약을 찾는 방법, 기술 면접 준비 방법을 다룹니다.

2026년 Java Spring Boot 개발자 채용 동향: 구직 방법, 연봉 범위, 면접 준비
2026년 Java Spring Boot 개발자 채용 공고 찾는 방법, 급여 범위, 기술 요구 사항, 원격 근무 동향, 면접 준비 가이드를 안내합니다.