Spring Boot DevTools năm 2026: Hot Reload, LiveReload và năng suất lập trình
Hướng dẫn Spring Boot DevTools cho Spring Boot 4.1: cơ chế tự động khởi động lại, thuộc tính spring.devtools, LiveReload bị deprecated, lỗi classloader và @RestartScope với Testcontainers.

Với một ứng dụng web Java, vòng lặp sửa code, build lại rồi khởi động lại có thể tốn hàng chục giây cho mỗi thay đổi nhỏ. Spring Boot DevTools rút ngắn vòng lặp này xuống còn một đến hai giây bằng cách chỉ khởi động lại phần code đã thay đổi. Module này đi kèm mọi phiên bản Spring Boot, và trong Spring Boot 4.1 (dòng ổn định hiện tại, phiên bản 4.1.2 tại thời điểm viết bài), cơ chế tự động khởi động lại vẫn là tính năng năng suất chủ lực, trong khi LiveReload đã chính thức bị đánh dấu deprecated.
Spring Boot DevTools chia classpath thành hai classloader: base classloader dành cho các jar bên thứ ba và restart classloader dành cho các class của dự án. Khi một class đã biên dịch thay đổi, chỉ restart classloader bị loại bỏ và tạo lại, nhờ vậy việc khởi động lại nhanh hơn nhiều so với cold start. DevTools cũng tắt cache template và tự vô hiệu hóa khi ứng dụng được chạy dưới dạng gói java -jar.
Thêm dependency spring-boot-devtools
DevTools chỉ gồm một artifact duy nhất. Điểm quan trọng nằm ở scope: dependency này tuyệt đối không được lan sang các module khác hay lọt vào gói triển khai production. Maven thể hiện điều này bằng optional, còn Gradle dùng configuration developmentOnly do plugin Spring Boot cung cấp.
<!-- 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>Phiên bản tương đương cho Gradle chỉ cần một dòng:
dependencies {
// developmentOnly: on the classpath for bootRun, absent from bootJar
developmentOnly("org.springframework.boot:spring-boot-devtools")
}Cả plugin Maven lẫn Gradle đều mặc định loại DevTools khỏi file jar sau khi repackage. Ngoài ra, DevTools còn nhận diện kiểu khởi chạy "đóng gói hoàn chỉnh" (java -jar hoặc launcher có classloader tùy biến) và tự tắt, bởi tài liệu chính thức về DevTools xem mọi kiểu khởi chạy như vậy là môi trường production. Việc ép bật bằng -Dspring.devtools.restart.enabled=true vẫn có thể thực hiện, và đó chính là điều mà một bản triển khai production cần tránh.
Cơ chế hot reload thực sự của Spring Boot
Cụm từ "hot reload trong Spring Boot" thực ra hơi dễ gây hiểu nhầm. DevTools không hoán đổi bytecode bên trong một JVM đang chạy: nó thực hiện khởi động lại, nhưng là một lần khởi động lại có chi phí thấp.
| Cơ chế | Những gì thay đổi được mà không cần khởi động lại | Chi phí mỗi lần thay đổi | Công cụ |
|---|---|---|---|
| JVM HotSwap (debugger) | Chỉ phần thân method | Gần như bằng không | Debugger của bất kỳ IDE nào |
| Restart của DevTools | Mọi class, mọi bean, mọi cấu hình | Thường từ 1 đến 3 giây | spring-boot-devtools |
| Khởi động lại toàn bộ | Tất cả | Toàn bộ thời gian khởi động | Không có |
| Reloading agent | Phần lớn thay đổi cấu trúc class | Gần như bằng không | JRebel và các công cụ tương tự |
Thiết kế hai classloader chính là lý do giúp việc khởi động lại diễn ra nhanh. Các jar lấy từ Maven Central hiếm khi thay đổi trong một phiên làm việc, vì vậy chúng được giữ nguyên trong base classloader, cùng với toàn bộ công sức tối ưu mà JIT đã thực hiện. Các class của dự án trong target/classes hoặc build/classes nằm ở restart classloader. Mỗi khi có thay đổi, loader này bị loại bỏ, một loader mới được tạo ra, và ApplicationContext được dựng lại từ đầu.
Trong thực tế, có hai hệ quả đáng chú ý:
- Trạng thái bị mất. Cache trong bộ nhớ, session lưu trong bộ nhớ và tiến độ của các scheduled task đều biến mất sau mỗi lần khởi động lại. Đây là hành vi có chủ đích, vì context được dựng lại hoàn toàn.
- Việc khởi động lại được kích hoạt bởi classpath, không phải bởi trình soạn thảo. DevTools theo dõi kết quả biên dịch. Lưu một file
.javasẽ không có tác dụng gì cho đến khi IDE hoặc công cụ build biên dịch nó.
Điểm thứ hai giải thích phần lớn các phản ánh kiểu "DevTools không hoạt động". Trong IntelliJ IDEA, dự án cần được build (Ctrl+F9 / Cmd+F9), hoặc phải bật "Build project automatically" kèm thiết lập nâng cao cho phép auto-make khi ứng dụng đang chạy. Tài liệu Spring Boot của IntelliJ IDEA mô tả các tùy chọn run configuration ("On update action", "On frame deactivation") dùng để kích hoạt bước biên dịch này. Eclipse và Spring Tools biên dịch ngay khi lưu file, nên việc khởi động lại diễn ra mà không cần cấu hình thêm.
Tinh chỉnh tự động khởi động lại với các thuộc tính spring.devtools
DevTools có thể cấu hình thông qua các thuộc tính spring.devtools.*. Các giá trị mặc định trong Spring Boot 4.1.2 rất đáng nắm rõ vì chúng giải thích nhiều hành vi gây bất ngờ: bộ theo dõi file kiểm tra (polling) mỗi 1 giây và chờ một khoảng lặng 400 ms trước khi khởi động lại, để một lần biên dịch chạm vào nhiều file chỉ tạo ra một lần khởi động lại thay vì năm lần.
Cấu hình dưới đây điều chỉnh DevTools cho một dự án biên dịch chậm (build đa module lớn, ổ đĩa mạng, volume Docker) và phục vụ tài nguyên tĩnh từ thư mục build của frontend.
# 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=falseCác thuộc tính trên tuân theo một số quy tắc:
spring.devtools.restart.excludethay thế danh sách mặc định (META-INF/maven/**,META-INF/resources/**,resources/**,static/**,public/**,templates/**, các class test và file build info).additional-excludebổ sung vào danh sách đó, và gần như đây luôn là điều mong muốn.- Các tài nguyên bị loại trừ không làm ứng dụng khởi động lại, nhưng vẫn được phục vụ ở phiên bản mới nhất vì DevTools tắt các cache như
spring.thymeleaf.cachevà đặtspring.web.resources.cache.periodvề 0. - Trigger file phải nằm trên classpath (
src/main/resources/.reloadtrigger). IntelliJ IDEA Ultimate và Spring Tools đều có khả năng cập nhật file này sau mỗi lần build. spring.devtools.restart.enabled=falsetrongapplication.propertiessẽ dừng việc theo dõi file nhưng vẫn khởi tạo restart classloader. Để tắt hoàn toàn DevTools, cần đặt system property trong methodmaintrước khi gọiSpringApplication.run.
Với các thiết lập áp dụng cho mọi dự án trên cùng một máy, DevTools đọc một file toàn cục trong $HOME/.config/spring-boot/, có tên spring-boot-devtools.properties (hoặc .yaml / .yml). Đây là nơi thích hợp cho thiết lập trigger file mang tính cá nhân, không nên commit vào repository của nhóm. File này không hỗ trợ profile.
Sẵn sàng chinh phục phỏng vấn Spring Boot?
Luyện tập với mô phỏng tương tác, flashcards và bài kiểm tra kỹ thuật.
LiveReload trong Spring Boot: bị deprecated từ 4.1
LiveReload tự động làm mới trình duyệt khi một tài nguyên thay đổi. DevTools tích hợp sẵn một server tương thích LiveReload trên cổng 35729, và một tiện ích mở rộng của trình duyệt sẽ kết nối tới server này. Trong Spring Boot 4.1, server này mặc định bị tắt và phải được bật một cách tường minh:
# application-dev.properties
# Deprecated since Spring Boot 4.1.0, no replacement planned
spring.devtools.livereload.enabled=true
spring.devtools.livereload.port=35729Release notes của Spring Boot 4.1 nêu rõ: "Given its decrease in popularity and support, the LiveReload feature in Devtools is deprecated with no replacement." Các tiện ích trình duyệt hầu như không còn được bảo trì, và phần lớn frontend năm 2026 được xây dựng bằng Vite hoặc một dev server khác vốn đã có sẵn hot module replacement.
Các dự án Thymeleaf hiện có vẫn có thể giữ spring.devtools.livereload.enabled=true trong thời gian trước mắt, nhưng một thuộc tính bị deprecated trong Spring Boot là ứng viên cho việc loại bỏ ở một phiên bản major sau này. Với template render phía server, các thiết lập cache mà DevTools áp dụng đã đủ để một lần làm mới trình duyệt thủ công hiển thị template mới nhất mà không cần khởi động lại ứng dụng.
Những cạm bẫy của restart classloader và ClassCastException
Lỗi DevTools phổ biến nhất trông có vẻ vô lý: com.example.Order cannot be cast to com.example.Order. Hai tên class giống hệt nhau vì hai class này đến từ hai classloader khác nhau. Một Order được nạp bởi restart classloader, Order còn lại được nạp bởi base classloader (hoặc bởi một restart classloader cũ lẽ ra đã phải bị loại bỏ).
Lỗi này thường xuất hiện trong ba tình huống:
- Một thư viện giải tuần tự hóa (deserialize) đối tượng bằng
ObjectInputStreamtiêu chuẩn, vốn phân giải class thông qua sai loader. Cơ chế nhân bản session và một số loại cache hoạt động theo cách này. - Một module của dự án được sử dụng dưới dạng jar (chẳng hạn thư viện
commontrong build đa module) và rơi vào base classloader, trong khi các class tham chiếu tới nó lại nằm ở restart loader. - Một trường static giữ một instance được tạo ra trước lần khởi động lại gần nhất.
Đối với tình huống thứ hai, DevTools đọc file META-INF/spring-devtools.properties trên classpath. Các key trong file này di chuyển jar giữa hai classloader bằng biểu thức chính quy:
# 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.-]+\\.jarCác key chỉ cần là duy nhất: điều quyết định là tiền tố restart.include. hoặc restart.exclude.. Đối với tình huống thứ nhất, cách khắc phục là giải tuần tự hóa bằng ConfigurableObjectInputStream của Spring và truyền vào Thread.currentThread().getContextClassLoader(), vốn luôn trỏ tới restart loader hiện hành.
Khi việc khởi động lại vẫn quá chậm hoặc không thể xử lý triệt để các vấn đề classloader, phương án dự phòng được tài liệu hóa là một reloading agent như JRebel, công cụ định nghĩa lại class ngay tại chỗ thay vì khởi động lại context.
DevTools kết hợp với Testcontainers và @RestartScope
Kể từ Spring Boot 3.1, một dự án có thể khởi chạy database và message broker thông qua Testcontainers ngay trong giai đoạn phát triển, với một launcher class nằm trong src/test/java. Sự kết hợp này hoạt động kém nếu khởi động lại một cách ngây thơ: mỗi lần khởi động lại sẽ hủy và tạo lại container PostgreSQL, tốn vài giây và xóa sạch dữ liệu.
@RestartScope, nằm trong module DevTools, giải quyết chính xác vấn đề này. Một bean được đánh dấu bằng annotation này sẽ tồn tại xuyên suốt các lần khởi động lại của DevTools. Cấu hình bên dưới tuân theo hướng dẫn development-time services của Spring Boot, với tên package của Testcontainers 2 được Spring Boot 4 sử dụng.
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");
}
}Launcher tái sử dụng method main thật và bổ sung cấu hình trên:
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);
}
}Ứng dụng được khởi chạy bằng ./mvnw spring-boot:test-run hoặc ./gradlew bootTestRun. Có một chi tiết của Gradle âm thầm làm hỏng cấu hình này: với developmentOnly, DevTools không có mặt trên classpath của bootTestRun, nên các thay đổi code đều bị bỏ qua. Dependency cần được chuyển sang testAndDevelopmentOnly("org.springframework.boot:spring-boot-devtools"). Phần integration test của cấu hình này được trình bày trong hướng dẫn Testcontainers cho Spring Boot.
Remote DevTools và lý do production luôn là vùng cấm
DevTools còn có thể đẩy thay đổi tới một ứng dụng đang chạy ở nơi khác, chẳng hạn trong một container trên server phát triển dùng chung. Phía server từ xa chỉ được kích hoạt khi spring.devtools.remote.secret được thiết lập và DevTools được đóng gói tường minh vào gói triển khai (excludeDevtools=false trên plugin Maven). Phía client là org.springframework.boot.devtools.RemoteSpringApplication, được chạy từ IDE với URL từ xa làm tham số.
Tài liệu xác định ranh giới rất rõ ràng: remote DevTools chỉ được chạy trên mạng tin cậy hoặc qua HTTPS, không bao giờ chạy trên production, và không hỗ trợ ứng dụng Spring WebFlux. Một endpoint nhận file class rồi khởi động lại ứng dụng, xét về bản chất, chính là một kênh thực thi mã từ xa. Trong phần lớn các thiết lập năm 2026, chạy ứng dụng cục bộ với các dịch vụ Testcontainers hoặc Docker Compose mang lại vòng lặp nhanh hơn mà không có rủi ro phơi nhiễm nói trên.
Câu hỏi phỏng vấn về Spring Boot DevTools
Trong các buổi phỏng vấn Spring Boot, DevTools thường được dùng làm cửa ngõ dẫn tới một chủ đề sâu hơn: cơ chế nạp class và vòng đời của application context. Dưới đây là những câu hỏi xuất hiện thường xuyên nhất, kèm câu trả lời mà một developer có kinh nghiệm được kỳ vọng đưa ra:
- "DevTools thực hiện hot swap hay khởi động lại?" Khởi động lại. DevTools loại bỏ restart classloader và dựng lại
ApplicationContext, trong khi JVM và base classloader vẫn tiếp tục hoạt động. Trả lời "hot swap" là lỗi kinh điển của developer junior. - "Vì sao để DevTools trong pom vẫn an toàn?" Có ba lớp bảo vệ: scope
optionalhoặcdevelopmentOnly, việc loại khỏi jar sau repackage, và cơ chế tự tắt khi chạyjava -jar. Một câu trả lời tốt sẽ nhắc tới việc épspring.devtools.restart.enabled=truesẽ vượt qua lớp bảo vệ thứ ba. - "Lỗi
X cannot be cast to Xbắt nguồn từ đâu?" Hai classloader cùng nạp một class, được khắc phục bằngMETA-INF/spring-devtools.propertieshoặc context classloader. - "Điều gì xảy ra với cache trong bộ nhớ khi khởi động lại?" Cache bị mất, trừ khi bean nằm trong
@RestartScope.
Các câu hỏi này giao thoa với chủ đề cấu hình, vì vậy module câu hỏi phỏng vấn Spring Boot DevTools nên được ôn luyện cùng module profiles và environment, bởi profile dev là nơi phù hợp cho hầu hết các thuộc tính kể trên. Toàn bộ ngân hàng câu hỏi có tại trang công nghệ Spring Boot.
Checklist thiết lập Spring Boot DevTools cho năm 2026
- Khai báo
spring-boot-devtoolsvớioptional(Maven) hoặcdevelopmentOnly(Gradle), và chuyển sangtestAndDevelopmentOnlykhi chạy launcher Testcontainers bằngbootTestRun. - Đảm bảo IDE biên dịch khi lưu file hoặc khi cửa sổ mất focus, vì DevTools theo dõi class đã biên dịch chứ không theo dõi file mã nguồn.
- Dùng
spring.devtools.restart.additional-excludethay choexcludeđể giữ nguyên các loại trừ mặc định cho tài nguyên tĩnh và template. - Thiết lập trigger file trong file toàn cục
~/.config/spring-boot/spring-boot-devtools.propertieskhi việc khởi động lại liên tục trong lúc refactor bắt đầu gây cản trở. - Xem LiveReload là tính năng deprecated kể từ Spring Boot 4.1.0, thay vào đó dựa vào dev server của frontend hoặc làm mới trình duyệt thủ công.
- Đánh dấu các container phát triển bằng
@RestartScopeđể PostgreSQL hay Kafka tồn tại qua mỗi lần khởi động lại. - Chẩn đoán lỗi
X cannot be cast to Xlà hiện tượng tách classloader và khắc phục bằng các mụcrestart.include.
Với scope dependency chính xác, IDE biên dịch tự động và một vài thuộc tính được tinh chỉnh hợp lý, Spring Boot DevTools giúp vòng lặp phát triển Java trở nên phản hồi nhanh hơn rõ rệt. Hiểu được cơ chế hai classloader phía sau cũng là một lợi thế thực sự khi gặp các câu hỏi phỏng vấn về classloading và application context.
Bắt đầu luyện tập!
Kiểm tra kiến thức với mô phỏng phỏng vấn và bài kiểm tra kỹ thuật.
Bạn có tìm ra lỗi trong Spring Boot không?
Một đoạn mã thật, một lỗi ẩn, mỗi ngày một lượt. Không cần tài khoản để thử.

Viết bởi
Anthony Fillion-MailletNgười sáng lập SharpSkill
Lập trình viên fullstack hơn 10 năm. Anh điều hành SharpSkill và chịu trách nhiệm về mọi nội dung đăng tại đây.
Cập nhật ngày 12 tháng 11, 2026
Thẻ
Chia sẻ
Bài viết liên quan

Testcontainers Spring Boot: kiểm thử tích hợp không đau đầu
Hướng dẫn đầy đủ về cấu hình Testcontainers với Spring Boot 3.4. PostgreSQL, Redis và Kafka trong các container Docker để kiểm thử tích hợp đáng tin cậy và có thể tái lập.

Việc làm Freelance Developer Java Spring Boot 2026: Tìm hợp đồng ở đâu, mức giá theo ngày, cách chuẩn bị
Hướng dẫn toàn diện cho developer freelance Java Spring Boot năm 2026: nền tảng tìm kiếm hợp đồng, mức giá theo ngày tại các quốc gia, và cách chuẩn bị cho phỏng vấn kỹ thuật.

Việc làm Java Spring Boot Developer 2026: Nơi Tìm Kiếm, Mức Lương, Cách Chuẩn Bị Phỏng Vấn
Hướng dẫn toàn diện về việc làm Java Spring Boot developer năm 2026: nền tảng tìm kiếm việc làm, dữ liệu lương cập nhật, và chiến lược chuẩn bị phỏng vấn cho vị trí backend enterprise.