# Spring Boot DevToolsの使い方【2026年版】ホットリロードとLiveReloadで開発を高速化 > Spring Boot 4.1 に対応した Spring Boot DevTools 入門。自動再起動の仕組み、spring.devtools プロパティの調整、非推奨となった LiveReload、ClassCastException の原因、Testcontainers と @RestartScope の活用法を解説します。 - Published: 2026-11-12 - Updated: 2026-11-12 - Author: Anthony Fillion-Maillet - Tags: spring boot devtools, ホットリロード, livereload, 開発生産性, testcontainers - Reading time: 11 min --- 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 org.springframework.boot spring-boot-devtools true ``` Gradle の場合は 1 行で済みます。 ```kotlin // build.gradle.kts 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 の公式リファレンス](https://docs.spring.io/spring-boot/reference/using/devtools.html)は、そうした起動を本番環境とみなしているためです。`-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 ドキュメント](https://www.jetbrains.com/help/idea/spring-boot.html)に説明があります。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 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 のリリースノート](https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-4.1-Release-Notes)には、利用者とサポートの減少を理由に 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 の開発時サービスに関するガイド](https://docs.spring.io/spring-boot/reference/features/dev-services.html)に沿ったもので、Spring Boot 4 が利用する Testcontainers 2 のパッケージ名を使用しています。 ```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"); } } ``` ランチャーは本来の `main` メソッドを再利用し、この設定クラスを追加します。 ```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); } } ``` アプリケーションは `./mvnw spring-boot:test-run` または `./gradlew bootTestRun` で起動します。Gradle には、この構成を気づかないうちに壊してしまう落とし穴が 1 つあります。`developmentOnly` のままだと DevTools が `bootTestRun` のクラスパスに含まれず、コードの変更が無視されるのです。依存関係は `testAndDevelopmentOnly("org.springframework.boot:spring-boot-devtools")` に変更する必要があります。この構成の統合テスト側については [Testcontainers と Spring Boot のガイド](https://sharpskill.dev/ja/blog/spring-boot/testcontainers-spring-boot-integration-testing)で詳しく扱っています。 ## リモート 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 の面接質問モジュール](https://sharpskill.dev/ja/technologies/spring-boot/interview-questions/spring-boot-devtools)と[プロファイルと環境のモジュール](https://sharpskill.dev/ja/technologies/spring-boot/interview-questions/profiles-environment)を合わせて学習すると効果的です。前述のプロパティの多くは `dev` プロファイルに置くのが自然だからです。質問集の全体は [Spring Boot の技術ページ](https://sharpskill.dev/ja/technologies/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` プロファイルにまとめておくことで、本番環境の安全性を損なうことなく高速な開発サイクルを手に入れられます。 --- Source: SharpSkill (https://sharpskill.dev), tech interview preparation for your real stack. HTML version of this page: https://sharpskill.dev/ja/blog/spring-boot/spring-boot-devtools-hot-reload-livereload