Spring Boot DevToolsの使い方【2026年版】ホットリロードとLiveReloadで開発を高速化

Spring Boot 4.1 に対応した Spring Boot DevTools 入門。自動再起動の仕組み、spring.devtools プロパティの調整、非推奨となった LiveReload、ClassCastException の原因、Testcontainers と @RestartScope の活用法を解説します。

Spring Boot DevTools のホットリロードで Java アプリケーションを再起動する様子

Spring Boot で Web アプリケーションを開発していると、コードを 1 行直すたびにビルドと再起動を待つ時間が積み重なります。Spring Boot DevTools は、変更されたプロジェクトのクラスだけを読み込み直すことで、この待ち時間を 1〜2 秒程度まで短縮するモジュールです。2026 年 11 月時点の安定版である Spring Boot 4.1(執筆時点で 4.1.2)でも自動再起動は DevTools の中心機能であり続けていますが、ブラウザを自動更新する LiveReload は非推奨になりました。本記事では、依存関係の正しい宣言から再起動の仕組み、プロパティの調整、クラスローダー由来のトラブル、Testcontainers との組み合わせまでを順に解説します。

Spring Boot DevTools の要点

Spring Boot DevTools はクラスパスを 2 つのクラスローダーに分けます。サードパーティの jar を読み込むベースクラスローダーと、プロジェクト自身のクラスを読み込むリスタートクラスローダーです。コンパイル済みクラスが変わると、破棄されて作り直されるのはリスタートクラスローダーだけなので、コールドスタートよりはるかに速く再起動できます。さらに DevTools はテンプレートのキャッシュを無効化し、java -jar で起動されたパッケージ済みアプリケーションでは自動的に無効になります。

spring-boot-devtools の依存関係を追加する

DevTools は 1 つのアーティファクトだけで構成されています。注意すべきはスコープです。この依存関係が他のモジュールや本番用アーカイブに混入してはいけません。Maven では optional、Gradle では Spring Boot プラグインが提供する developmentOnly 構成でこれを表現します。

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 の場合は 1 行で済みます。

build.gradle.ktskotlin
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 の中でバイトコードを差し替えているわけではありません。実際に行っているのは再起動であり、ただしその再起動が非常に軽量なのです。

仕組み再起動なしで反映できる範囲変更 1 回あたりのコストツール
JVM HotSwap(デバッガー)メソッド本体のみほぼゼロ各 IDE のデバッガー
DevTools の再起動あらゆるクラス、Bean、設定通常 1〜3 秒spring-boot-devtools
完全な再起動すべて起動時間そのものなし
リロードエージェントクラス構造の変更の大半ほぼゼロJRebel など

再起動を速くしているのは 2 つのクラスローダーによる設計です。Maven Central から取得した jar は開発中にほとんど変わらないため、JIT コンパイルの成果も含めてベースクラスローダーに読み込まれたまま残ります。一方、target/classes や build/classes にあるプロジェクトのクラスはリスタートクラスローダーに置かれます。変更が起きるとこのローダーが破棄されて新しく作られ、ApplicationContext が最初から組み立て直されます。

実務上、ここから 2 つの重要な帰結が導かれます。

  • 状態は失われます。 メモリ上のキャッシュ、インメモリのセッション、スケジュールタスクの進行状況は、再起動のたびに消えます。コンテキストを作り直す以上、これは仕様どおりの動作です。
  • 再起動のきっかけはエディターではなくクラスパスです。 DevTools が監視しているのはコンパイル結果です。.java ファイルを保存しただけでは、IDE やビルドツールがコンパイルするまで何も起こりません。

「DevTools が動かない」という報告の大半は、この 2 点目で説明できます。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 ミリ秒の静止期間を待ちます。複数ファイルのコンパイルが 5 回の再起動ではなく 1 回の再起動にまとまるのは、この静止期間のおかげです。

次の設定は、コンパイルに時間のかかるプロジェクト(大規模なマルチモジュール構成、ネットワークドライブ、Docker ボリュームなど)で、フロントエンドのビルド成果物を静的アセットとして配信するケースを想定したものです。

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

これらのプロパティには、押さえておくべきルールがいくつかあります。

  • 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 ではこのサーバーはデフォルトで無効になっており、明示的に有効化する必要があります。

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 のリリースノートには、利用者とサポートの減少を理由に DevTools の LiveReload 機能を非推奨とし、代替機能は提供しないとはっきり書かれています。ブラウザ拡張機能はほとんどメンテナンスされておらず、2026 年のフロントエンドの多くは、ホットモジュールリプレースメントを標準で備えた Vite などの開発サーバーで構築されています。

新しい開発フローを LiveReload の上に組まない

既存の Thymeleaf プロジェクトでは当面 spring.devtools.livereload.enabled=true を使い続けられます。ただし Spring Boot で非推奨となったプロパティは、将来のメジャーバージョンで削除される候補です。サーバーサイドでレンダリングするテンプレートについては、DevTools が適用するキャッシュ設定のおかげで、ブラウザを手動で更新するだけでアプリケーションを再起動せずに最新のテンプレートが表示されます。

リスタートクラスローダーの落とし穴と ClassCastException

DevTools で最もよく見かける不具合は、一見すると理不尽なものです。com.example.Order cannot be cast to com.example.Order というエラーで、クラス名はまったく同じです。同じ名前なのにキャストできないのは、2 つのクラスが別々のクラスローダーから読み込まれているからです。一方の Order はリスタートクラスローダー、もう一方はベースクラスローダー(あるいは本来破棄されているはずの以前のリスタートクラスローダー)によって読み込まれています。

典型的には次の 3 つの状況で発生します。

  1. ライブラリが標準の ObjectInputStream でオブジェクトをデシリアライズし、誤ったローダー経由でクラスを解決している。セッションレプリケーションや一部のキャッシュがこれに該当します。
  2. プロジェクト内のモジュールが jar として参照されており(マルチモジュール構成の common ライブラリなど)、それがベースクラスローダーに入る一方で、参照する側のクラスはリスタートクラスローダーにある。
  3. 前回の再起動より前に生成されたインスタンスを static フィールドが保持している。

2 つ目のケースに対しては、DevTools がクラスパス上の META-INF/spring-devtools.properties を読み込みます。このファイルのキーを使うと、正規表現で jar を 2 つのクラスローダーの間で移動できます。

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

キーは一意でありさえすればよく、意味を持つのは restart.include. または restart.exclude. という接頭辞です。1 つ目のケースは、Spring の ConfigurableObjectInputStream でデシリアライズし、現在のリスタートクラスローダーを指す Thread.currentThread().getContextClassLoader() を渡すことで解決できます。

それでも再起動が遅すぎる場合や、クラスローダーの問題がどうしても解消できない場合、ドキュメントが示す代替手段は JRebel のようなリロードエージェントです。これはコンテキストを再起動するのではなく、クラスをその場で再定義します。

DevTools と Testcontainers、そして @RestartScope

Spring Boot 3.1 以降、開発時にデータベースやメッセージブローカーを Testcontainers で起動できるようになりました。ランチャークラスは src/test/java に置きます。ただし、素朴な再起動との相性は良くありません。再起動のたびに PostgreSQL コンテナが破棄されて作り直され、数秒が失われるうえにデータも消えてしまいます。

この問題をまさに解決するのが、DevTools モジュールに含まれる @RestartScope です。このアノテーションを付けた Bean は DevTools の再起動をまたいで生き残ります。以下の構成は Spring Boot の開発時サービスに関するガイドに沿ったもので、Spring Boot 4 が利用する Testcontainers 2 のパッケージ名を使用しています。

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

ランチャーは本来の main メソッドを再利用し、この設定クラスを追加します。

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

アプリケーションは ./mvnw spring-boot:test-run または ./gradlew bootTestRun で起動します。Gradle には、この構成を気づかないうちに壊してしまう落とし穴が 1 つあります。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 に残しておいても安全なのはなぜですか」 3 つの層で守られているからです。optional または developmentOnly のスコープ、再パッケージ化された jar からの除外、そして java -jar 起動時の自動無効化です。spring.devtools.restart.enabled=true を強制すると 3 つ目の層が回避されることにも触れられると、評価の高い回答になります。
  • 「X cannot be cast to X はなぜ起きるのですか」 2 つのクラスローダーが同じクラスを読み込んでいるためです。META-INF/spring-devtools.properties かコンテキストクラスローダーで解決します。
  • 「再起動するとメモリ上のキャッシュはどうなりますか」 Bean が @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 は、魔法のようなホットスワップではなく、2 つのクラスローダーを使った軽量な再起動の仕組みです。この前提を理解しておけば、状態が失われる理由、IDE のコンパイル設定が重要な理由、そして X cannot be cast to X のような不可解なエラーの原因も自然に説明できます。Spring Boot 4.1 では LiveReload が非推奨となり、開発体験の重心は自動再起動と、@RestartScope を活用した Testcontainers ベースの開発環境へと移っています。依存関係のスコープを正しく設定し、プロパティを dev プロファイルにまとめておくことで、本番環境の安全性を損なうことなく高速な開発サイクルを手に入れられます。

今すぐ練習を始めましょう!

面接シミュレーターと技術テストで知識をテストしましょう。

今日のチャレンジ

Spring Boot のバグを見つけられますか

実際のコード、隠れたバグ、1日1回。アカウントなしで試せます。

Anthony Fillion-Maillet

執筆

Anthony Fillion-Maillet

SharpSkill 創業者

10 年以上フルスタック開発に携わっています。SharpSkill を運営し、ここで公開される内容に責任を負っています。

2026年11月12日 更新

タグ

#spring boot devtools
#ホットリロード
#livereload
#開発生産性
#testcontainers

共有

関連記事