# 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. - Published: 2026-11-12 - Updated: 2026-11-12 - Author: Anthony Fillion-Maillet - Tags: spring boot devtools, hot reload, livereload, geliştirici verimliliği, testcontainers - Reading time: 11 min --- 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 org.springframework.boot spring-boot-devtools true ``` Gradle karşılığı tek satırdır: ```kotlin // build.gradle.kts 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](https://docs.spring.io/spring-boot/reference/using/devtools.html) 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 `.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](https://www.jetbrains.com/help/idea/spring-boot.html), 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 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ı](https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-4.1-Release-Notes) 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](https://docs.spring.io/spring-boot/reference/features/dev-services.html) izler ve Spring Boot 4'ün kullandığı Testcontainers 2 paket adlarını kullanır. ```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"); } } ``` Başlatıcı sınıf gerçek `main` metodunu yeniden kullanır ve yapılandırmayı ekler: ```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); } } ``` 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](https://sharpskill.dev/tr/blog/spring-boot/testcontainers-spring-boot-integration-testing) 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ü](https://sharpskill.dev/tr/technologies/spring-boot/mulakat-sorulari/spring-boot-devtools), [profiller ve ortam modülü](https://sharpskill.dev/tr/technologies/spring-boot/mulakat-sorulari/profiles-environment) 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](https://sharpskill.dev/tr/technologies/spring-boot) 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. --- Source: SharpSkill (https://sharpskill.dev), tech interview preparation for your real stack. HTML version of this page: https://sharpskill.dev/tr/blog/spring-boot/spring-boot-devtools-hot-reload-livereload