2026'da Spring Boot DevTools: Hot Reload, LiveReload ve Geliştirici Verimliliği
Spring Boot DevTools rehberi: restart tabanlı hot reload nasıl çalışır, spring.devtools ayarları, 4.1'de kullanımdan kalkan LiveReload, ClassCastException ve Testcontainers ile @RestartScope.

Java ile yazılmış bir web uygulamasında "düzenle, derle, yeniden başlat" döngüsü her küçük değişiklikte on saniyeyi aşabilir. Spring Boot DevTools bu döngüyü bir iki saniyeye indirir, çünkü uygulamanın tamamını değil yalnızca projenin kendi kodunu yeniden yükler. Modül her Spring Boot sürümüyle birlikte gelir ve 4.1 serisinde (şu an güncel kararlı sürüm 4.1.2) otomatik yeniden başlatma en önemli üretkenlik özelliği olmayı sürdürür. Diğer bilinen özellik olan LiveReload ise kullanımdan kaldırılmış (deprecated) olarak işaretlenmiştir.
DevTools classpath'i iki classloader'a böler: üçüncü taraf jar dosyalarını tutan bir temel (base) classloader ve proje sınıflarını barındıran bir restart classloader. Derlenmiş bir sınıf değiştiğinde yalnızca restart classloader atılıp yeniden oluşturulur; bu yüzden yeniden başlatma soğuk bir açılıştan çok daha hızlıdır. DevTools ayrıca şablon önbelleğini kapatır ve java -jar ile çalıştırılan paketlenmiş uygulamalarda kendini devre dışı bırakır.
spring-boot-devtools bağımlılığını eklemek
DevTools tek bir artifact'tan oluşur. Asıl önemli olan kapsamıdır (scope): bağımlılık başka modüllere ya da üretim arşivine asla sızmamalıdır. Maven bunu optional ile, Gradle ise Spring Boot eklentisinin sağladığı developmentOnly yapılandırmasıyla ifade eder.
<!-- 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 karşılığı tek satırdır:
dependencies {
// developmentOnly: on the classpath for bootRun, absent from bootJar
developmentOnly("org.springframework.boot:spring-boot-devtools")
}Hem Maven hem de Gradle eklentisi, yeniden paketlenen jar dosyasından DevTools'u varsayılan olarak çıkarır. Bunun da ötesinde DevTools, "tamamen paketlenmiş" bir başlatmayı (java -jar ya da özel bir launcher classloader) algılar ve kendini kapatır; çünkü resmi DevTools dokümantasyonu bu tür her başlatmayı üretim ortamı olarak kabul eder. -Dspring.devtools.restart.enabled=true ile zorla etkinleştirmek mümkündür ve bir üretim dağıtımının kaçınması gereken şey tam olarak budur.
Spring Boot hot reload gerçekte nasıl çalışır
"Spring Boot hot reload" ifadesi biraz yanıltıcıdır. DevTools çalışan bir JVM içinde bytecode değiştirmez; bir yeniden başlatma (restart) gerçekleştirir, ancak bu son derece ucuz bir yeniden başlatmadır.
| Mekanizma | Yeniden başlatmadan neler değişir | Değişiklik başına maliyet | Araç |
|---|---|---|---|
| JVM HotSwap (debugger) | Yalnızca metot gövdeleri | Neredeyse sıfır | Herhangi bir IDE debugger'ı |
| DevTools restart | Her sınıf, her bean, her yapılandırma | Genellikle 1 ila 3 saniye | spring-boot-devtools |
| Tam yeniden başlatma | Her şey | Tam açılış süresi | Yok |
| Yeniden yükleme ajanları | Sınıf yapısındaki değişikliklerin çoğu | Neredeyse sıfır | JRebel ve benzerleri |
Yeniden başlatmayı hızlı kılan, iki classloader'lı tasarımdır. Maven Central'dan gelen jar dosyaları bir oturum boyunca nadiren değişir; bu nedenle JIT derleyicisinin üzerlerinde yaptığı işle birlikte temel classloader'da yüklü kalırlar. target/classes ya da build/classes dizinindeki proje sınıfları ise restart classloader'da yaşar. Bir değişiklik bu loader'ı çöpe atar, yenisi oluşturulur ve ApplicationContext sıfırdan inşa edilir.
Pratikte iki sonuç önem taşır:
- Durum kaybolur. Bellek içi önbellekler, bellekte tutulan oturumlar ve zamanlanmış görevlerin ilerlemesi her yeniden başlatmada silinir. Bu bilinçli bir tasarımdır: context yeniden kurulur.
- Yeniden başlatmayı editör değil classpath tetikler. DevTools derlenmiş çıktıyı izler. Bir
.javadosyasını kaydetmek, IDE ya da derleme aracı onu derleyene kadar hiçbir şey yapmaz.
İkinci nokta, "DevTools çalışmıyor" şikâyetlerinin büyük kısmını açıklar. IntelliJ IDEA'da projenin derlenmesi (Ctrl+F9 / Cmd+F9) ya da "Build project automatically" seçeneğinin, uygulama çalışırken otomatik derlemeye izin veren gelişmiş ayarla birlikte açılması gerekir. IntelliJ IDEA Spring Boot dokümantasyonu, bu derleme adımını tetikleyen çalıştırma yapılandırması seçeneklerini ("On update action", "On frame deactivation") ayrıntılı olarak anlatır. Eclipse ve Spring Tools kaydetme anında derlediği için yeniden başlatma ek yapılandırma gerektirmeden gerçekleşir.
spring.devtools özellikleriyle otomatik yeniden başlatmayı ayarlamak
DevTools, spring.devtools.* özellikleri üzerinden yapılandırılır. Spring Boot 4.1.2'deki varsayılan değerleri bilmek faydalıdır, çünkü birkaç şaşırtıcı davranışı açıklarlar: dosya izleyici her 1 saniyede bir kontrol yapar ve yeniden başlatmadan önce 400 ms boyunca sessizlik bekler. Böylece birden fazla dosyanın derlenmesi beş ayrı yeniden başlatma yerine tek bir yeniden başlatmayla sonuçlanır.
Aşağıdaki yapılandırma, DevTools'u yavaş derlenen (büyük çok modüllü yapı, ağ sürücüsü, Docker volume) ve statik varlıklarını bir frontend derleme klasöründen sunan bir projeye uyarlar.
# 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=falseBu özellikler birkaç kurala tabidir:
spring.devtools.restart.excludevarsayılan listeyi (META-INF/maven/**,META-INF/resources/**,resources/**,static/**,public/**,templates/**, test sınıfları ve build info dosyaları) tamamen değiştirir.additional-excludeise listeye ekleme yapar ve neredeyse her zaman istenen davranış budur.- Hariç tutulan kaynaklar uygulamayı yeniden başlatmaz, yine de güncel halleriyle sunulurlar; çünkü DevTools
spring.thymeleaf.cachegibi önbellekleri kapatır vespring.web.resources.cache.perioddeğerini 0 yapar. - Tetikleyici dosya classpath üzerinde bulunmalıdır (
src/main/resources/.reloadtrigger). IntelliJ IDEA Ultimate ve Spring Tools, bir derlemeden sonra bu dosyayı güncellemeyi bilir. application.propertiesiçindekispring.devtools.restart.enabled=falsedosya izlemeyi durdurur, ancak restart classloader yine de başlatılır. DevTools'u tamamen kapatmak için sistem özelliğininmainmetodunda,SpringApplication.runçağrısından önce ayarlanması gerekir.
Bir makinedeki tüm projeler için geçerli olacak ayarları DevTools, $HOME/.config/spring-boot/ altındaki spring-boot-devtools.properties (veya .yaml / .yml) adlı global bir dosyadan okur. Ekip deposuna commit edilmemesi gereken kişisel bir tetikleyici dosya ayarı için doğru yer burasıdır. Bu dosyada profiller desteklenmez.
Spring Boot mülakatlarında başarılı olmaya hazır mısın?
İnteraktif simülatörler, flashcards ve teknik testlerle pratik yap.
Spring Boot LiveReload: 4.1 ile kullanımdan kaldırıldı
LiveReload, bir kaynak değiştiğinde tarayıcıyı otomatik olarak yeniler. DevTools, 35729 numaralı portta LiveReload uyumlu bir sunucu barındırır ve bir tarayıcı eklentisi bu sunucuya bağlanır. Spring Boot 4.1'de sunucu varsayılan olarak kapalıdır ve açıkça etkinleştirilmesi gerekir:
# 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 sürüm notları bunu açıkça belirtir: popülerliği ve desteği azaldığı için DevTools içindeki LiveReload özelliği, yerine bir alternatif getirilmeden kullanımdan kaldırılmıştır. Tarayıcı eklentileri neredeyse hiç bakım görmüyor ve 2026'daki frontend projelerinin çoğu, hot module replacement özelliğini zaten sunan Vite veya benzeri bir geliştirme sunucusuyla oluşturuluyor.
Mevcut Thymeleaf projeleri şimdilik spring.devtools.livereload.enabled=true ayarını koruyabilir, ancak Spring Boot'ta kullanımdan kaldırılmış bir özellik, sonraki bir ana sürümde kaldırılmaya adaydır. Sunucu tarafında render edilen şablonlarda, DevTools'un uyguladığı önbellek ayarları sayesinde tarayıcıyı elle yenilemek uygulamayı yeniden başlatmadan şablonun son halini göstermeye yeter.
Restart classloader tuzakları ve ClassCastException
En yaygın DevTools hatası ilk bakışta saçma görünür: com.example.Order cannot be cast to com.example.Order. İki sınıf adı aynıdır, çünkü iki sınıf iki farklı classloader'dan gelir. Order sınıflarından biri restart classloader tarafından, diğeri temel classloader tarafından (ya da atılmış olması gereken önceki bir restart classloader tarafından) yüklenmiştir.
Bu durum genellikle üç senaryoda ortaya çıkar:
- Bir kütüphane nesneleri standart
ObjectInputStreamile deserialize eder ve sınıfları yanlış loader üzerinden çözer. Oturum replikasyonu ve bazı önbellek mekanizmaları bu şekilde çalışır. - Bir proje modülü jar olarak tüketilir (çok modüllü bir yapıdaki
commonkütüphanesi gibi) ve temel classloader'a düşer; ona referans veren sınıflar ise restart loader'dadır. - Statik bir alan, son yeniden başlatmadan önce oluşturulmuş bir örneği tutar.
İkinci senaryo için DevTools, classpath'ten META-INF/spring-devtools.properties dosyasını okur. Bu dosyadaki anahtarlar, düzenli ifadeler kullanarak jar dosyalarını iki classloader arasında taşır:
# 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.-]+\\.jarAnahtarların yalnızca benzersiz olması yeterlidir; önemli olan restart.include. ya da restart.exclude. önekidir. Birinci senaryoda çözüm, Spring'in ConfigurableObjectInputStream sınıfıyla deserialize etmek ve geçerli restart loader'ı işaret eden Thread.currentThread().getContextClassLoader() değerini iletmektir.
Yeniden başlatmalar hâlâ çok yavaşsa ya da classloader sorunları çözülemiyorsa, belgelenmiş alternatif JRebel gibi bir yeniden yükleme ajanıdır. Bu tür ajanlar context'i yeniden başlatmak yerine sınıfları yerinde yeniden tanımlar.
Testcontainers ve @RestartScope ile DevTools
Spring Boot 3.1'den bu yana bir proje, src/test/java içindeki bir başlatıcı sınıf aracılığıyla veritabanlarını ve mesaj aracılarını geliştirme sırasında da Testcontainers ile ayağa kaldırabilir. Bu yaklaşım basit yeniden başlatmalarla kötü uyum sağlar: her yeniden başlatma PostgreSQL konteynerini yok edip yeniden oluşturur, bu da birkaç saniyeye mal olur ve verileri siler.
DevTools modülünde yer alan @RestartScope tam olarak bu sorunu çözer. Bu anotasyonla işaretlenen bir bean, DevTools yeniden başlatmalarından sağ çıkar. Aşağıdaki kurulum Spring Boot geliştirme zamanı servisleri kılavuzunu izler ve Spring Boot 4'ün kullandığı Testcontainers 2 paket adlarını kullanır.
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");
}
}Başlatıcı sınıf gerçek main metodunu yeniden kullanır ve yapılandırmayı ekler:
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);
}
}Uygulama ./mvnw spring-boot:test-run ya da ./gradlew bootTestRun ile başlatılır. Gradle tarafındaki bir ayrıntı bu kurulumu sessizce bozar: developmentOnly kullanıldığında DevTools, bootTestRun görevinin classpath'inde yer almaz ve kod değişiklikleri yok sayılır. Bağımlılığın testAndDevelopmentOnly("org.springframework.boot:spring-boot-devtools") yapılandırmasına taşınması gerekir. Bu kurulumun entegrasyon testi tarafı Testcontainers ile Spring Boot kılavuzunda ele alınmaktadır.
Uzak DevTools ve üretimin neden yasak bölge olduğu
DevTools, değişiklikleri başka bir yerde çalışan bir uygulamaya da gönderebilir; örneğin paylaşılan bir geliştirme sunucusundaki bir konteynere. Sunucu tarafı yalnızca spring.devtools.remote.secret ayarlandığında ve DevTools arşive açıkça dahil edildiğinde (Maven eklentisinde excludeDevtools=false) etkinleşir. İstemci, IDE'den uzak URL argüman olarak verilerek başlatılan org.springframework.boot.devtools.RemoteSpringApplication sınıfıdır.
Dokümantasyon sınırları net biçimde çizer: uzak DevTools yalnızca güvenilir bir ağ üzerinde ya da HTTPS ile çalıştırılmalı, asla üretimde kullanılmamalıdır ve Spring WebFlux uygulamalarını desteklemez. Sınıf dosyalarını kabul edip uygulamayı yeniden başlatan bir endpoint, yapısı gereği uzaktan kod çalıştırma kanalıdır. 2026'daki kurulumların çoğunda, uygulamayı Testcontainers ya da Docker Compose servisleriyle yerelde çalıştırmak bu riskin hiçbirini taşımadan daha hızlı bir döngü sağlar.
Spring Boot DevTools mülakat soruları
DevTools, Spring Boot mülakatlarında daha derin bir konunun habercisi olarak karşımıza çıkar: sınıf yükleme ve uygulama context'inin yaşam döngüsü. En sık sorulan sorular ve deneyimli bir geliştiriciden beklenen yanıtlar şöyledir:
- "DevTools hot swap mı yapar, yeniden başlatma mı?" Yeniden başlatma. Restart classloader'ı atar ve
ApplicationContext'i yeniden kurar; JVM ve temel classloader ayakta kalır. "Hot swap" yanıtı klasik bir junior hatasıdır. - "DevTools'u pom içinde bırakmak neden güvenlidir?" Üç katman vardır:
optionalya dadevelopmentOnlykapsamı, yeniden paketlenen jar'dan hariç tutulma vejava -jarile otomatik devre dışı kalma. Güçlü bir yanıt,spring.devtools.restart.enabled=truezorlamasının üçüncü katmanı atladığını da belirtir. - "
X cannot be cast to Xhatası nereden gelir?" Aynı sınıfı yükleyen iki classloader'dan. ÇözümMETA-INF/spring-devtools.propertiesya da context classloader kullanımıdır. - "Yeniden başlatmada bellek içi bir önbelleğe ne olur?" Bean
@RestartScopeiçinde değilse kaybolur.
Bu sorular yapılandırma konularıyla kesişir. Bu nedenle Spring Boot DevTools mülakat soruları modülü, profiller ve ortam modülü ile birlikte iyi bir ikili oluşturur; yukarıdaki özelliklerin çoğunun doğal yeri bir dev profilidir. Tüm soru bankası Spring Boot teknoloji sayfasında yer alır.
2026 için Spring Boot DevTools kurulum kontrol listesi
spring-boot-devtoolsbağımlılığınıoptional(Maven) ya dadevelopmentOnly(Gradle) olarak tanımlamak;bootTestRunile bir Testcontainers başlatıcısı çalıştırılırkentestAndDevelopmentOnlyyapılandırmasına geçmek.- IDE'nin kaydetme anında ya da pencere odağını kaybettiğinde derleme yaptığından emin olmak: DevTools kaynak dosyaları değil derlenmiş sınıfları izler.
- Varsayılan statik kaynak ve şablon hariç tutmalarını korumak için
excludeyerinespring.devtools.restart.additional-excludekullanmak. - Refactoring sırasında sürekli yeniden başlatmalar işi zorlaştırıyorsa global
~/.config/spring-boot/spring-boot-devtools.propertiesdosyasında bir tetikleyici dosya tanımlamak. - LiveReload'u Spring Boot 4.1.0'dan bu yana kullanımdan kaldırılmış kabul etmek ve bunun yerine frontend geliştirme sunucusuna ya da elle yenilemeye güvenmek.
- PostgreSQL veya Kafka'nın her yeniden başlatmadan sağ çıkması için geliştirme konteynerlerini
@RestartScopeile işaretlemek. X cannot be cast to Xhatasını bir classloader ayrışması olarak teşhis etmek verestart.includegirdileriyle düzeltmek.
Pratik yapmaya başla!
Mülakat simülatörleri ve teknik testlerle bilgini test et.
Spring Boot kodundaki hatayı bulabilir misin?
Gerçek bir kod parçası, gizli bir hata, günde bir deneme. Denemek için hesap gerekmez.

Yazan:
Anthony Fillion-MailletSharpSkill kurucusu
10 yılı aşkın süredir fullstack geliştirici. SharpSkill’i yönetiyor ve burada yayımlanan her şeyden sorumlu.
12 Kasım 2026 tarihinde güncellendi
Etiketler
Paylaş
İlgili makaleler

Testcontainers Spring Boot: sancısız entegrasyon testleri
Spring Boot 3.4 ile Testcontainers yapılandırması için eksiksiz rehber. Güvenilir ve tekrarlanabilir entegrasyon testleri için Docker konteynerlerinde PostgreSQL, Redis ve Kafka.

2026'da freelance Java Spring Boot geliştirici işleri: sözleşmeleri nerede bulunur, günlük ücretler, nasıl hazırlanılır
2026'da Spring Boot freelance sözleşmelerini nerede bulacağınız, Avrupa genelindeki günlük ücretler ve teknik mülakatlara nasıl hazırlanacağınız.

2026'da Java Spring Boot Geliştirici İş İlanları: Nerede Aramak, Maaş Aralıkları, Nasıl Hazırlanmak
2026 yılında Java Spring Boot geliştirici iş ilanları: güncel maaş aralıkları, iş arama platformları ve mülakat hazırlığı stratejileri.