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.

Spring Boot DevTools ile Java uygulamasının hot reload ile yeniden başlatılması

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.

Tek paragrafta Spring Boot DevTools

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.

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 karşılığı tek satırdır:

build.gradle.ktskotlin
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.

MekanizmaYeniden başlatmadan neler değişirDeğişiklik başına maliyetAraç
JVM HotSwap (debugger)Yalnızca metot gövdeleriNeredeyse sıfırHerhangi bir IDE debugger'ı
DevTools restartHer sınıf, her bean, her yapılandırmaGenellikle 1 ila 3 saniyespring-boot-devtools
Tam yeniden başlatmaHer şeyTam açılış süresiYok
Yeniden yükleme ajanlarıSınıf yapısındaki değişikliklerin çoğuNeredeyse sıfırJRebel 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 .java dosyası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.

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

Bu özellikler birkaç kurala tabidir:

  • spring.devtools.restart.exclude varsayı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-exclude ise 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.cache gibi önbellekleri kapatır ve spring.web.resources.cache.period değ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.properties içindeki spring.devtools.restart.enabled=false dosya izlemeyi durdurur, ancak restart classloader yine de başlatılır. DevTools'u tamamen kapatmak için sistem özelliğinin main metodunda, 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:

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 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.

Yeni bir iş akışı LiveReload üzerine kurulmamalı

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:

  1. Bir kütüphane nesneleri standart ObjectInputStream ile deserialize eder ve sınıfları yanlış loader üzerinden çözer. Oturum replikasyonu ve bazı önbellek mekanizmaları bu şekilde çalışır.
  2. Bir proje modülü jar olarak tüketilir (çok modüllü bir yapıdaki common kütüphanesi gibi) ve temel classloader'a düşer; ona referans veren sınıflar ise restart loader'dadır.
  3. 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:

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

Anahtarları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.

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");
    }
}

Başlatıcı sınıf gerçek main metodunu yeniden kullanır ve yapılandırmayı ekler:

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);
    }
}

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: optional ya da developmentOnly kapsamı, yeniden paketlenen jar'dan hariç tutulma ve java -jar ile otomatik devre dışı kalma. Güçlü bir yanıt, spring.devtools.restart.enabled=true zorlamasının üçüncü katmanı atladığını da belirtir.
  • "X cannot be cast to X hatası nereden gelir?" Aynı sınıfı yükleyen iki classloader'dan. Çözüm META-INF/spring-devtools.properties ya da context classloader kullanımıdır.
  • "Yeniden başlatmada bellek içi bir önbelleğe ne olur?" Bean @RestartScope iç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-devtools bağımlılığını optional (Maven) ya da developmentOnly (Gradle) olarak tanımlamak; bootTestRun ile bir Testcontainers başlatıcısı çalıştırılırken testAndDevelopmentOnly yapı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 exclude yerine spring.devtools.restart.additional-exclude kullanmak.
  • Refactoring sırasında sürekli yeniden başlatmalar işi zorlaştırıyorsa global ~/.config/spring-boot/spring-boot-devtools.properties dosyası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 @RestartScope ile işaretlemek.
  • X cannot be cast to X hatasını bir classloader ayrışması olarak teşhis etmek ve restart.include girdileriyle düzeltmek.

Pratik yapmaya başla!

Mülakat simülatörleri ve teknik testlerle bilgini test et.

Günün meydan okuması

Spring Boot kodundaki hatayı bulabilir misin?

Gerçek bir kod parçası, gizli bir hata, günde bir deneme. Denemek için hesap gerekmez.

Anthony Fillion-Maillet

Yazan:

Anthony Fillion-Maillet

SharpSkill 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

#spring boot devtools
#hot reload
#livereload
#geliştirici verimliliği
#testcontainers

Paylaş

İlgili makaleler