はじめに
Spring Boot 4.0が2025年11月にリリースされました。Spring Boot 3.5の無償サポートは2026年6月で終わっているので、これから4への移行を検討する方も多いと思います。
この記事では、Spring Boot 3と4の違いを、比較表を中心に整理します。
- 対象読者:Spring Boot 3を使っていて、4で何が変わるのかを知りたい方
- 前提バージョン:Spring Boot 4.0 / Java 25
- この記事で分かること:3と4の世代の違い、4の主な新機能、移行で注意すべき点の全体像
結論
- Spring Boot 3は「JavaとJakarta EEの土台を一新し、その上に機能を積み上げた世代」です
- Spring Boot 4は「土台はそのままに、中身を整理・近代化した世代」です
- Javaの最低バージョンは17のままですが、Jackson 3への移行とスターターの再編成など、コードや設定の修正が必要な変更があります
Spring Boot 3と4の比較
まずは全体像を表で比べます。
| 観点 | Spring Boot 3 | Spring Boot 4 |
|---|---|---|
| リリース | 2022年11月〜 | 2025年11月〜 |
| Spring Framework | 6.x | 7.x |
| Java | 17以上 | 17以上(25推奨) |
| Jakarta EE | 9 / 10 | 11(Servlet 6.1) |
| JSON | Jackson 2 | Jackson 3 |
| 自動設定 | 1つの大きなjar | 技術ごとのモジュール |
| null安全 | Spring独自の注釈 | JSpecify |
| 世代のテーマ | 土台の刷新と機能追加 | 整理と近代化 |
Spring Boot 3.0では javax.* から jakarta.* へのパッケージ名の変更があり、これが最大の移行作業でした。Spring Boot 4では、Javaの最低バージョンが変わらないため、3.0のときほど大きな書き換えにはなりません。
Spring Boot 3で追加されてきた機能
Spring Boot 3は、3.0で土台を変えたあと、マイナーバージョンごとに機能が追加されてきました。
| バージョン | 主な機能 |
|---|---|
| 3.0 | Java 17必須、Jakarta EE移行、GraalVMネイティブイメージ、Observation API |
| 3.1 | Testcontainers連携(@ServiceConnection)、Docker Compose連携 |
| 3.2 | 仮想スレッド、RestClient、JdbcClient、CRaC |
| 3.3 | CDS(起動の高速化)、SBOM |
| 3.4 | 構造化ログ、MockMvcTester |
| 3.5 | 構造化ログの改善、環境変数からのプロパティ読み込み |
仮想スレッドやRestClientなど、今では当たり前に使う機能の多くが、3の途中で入っています。
Spring Boot 4の主な新機能
Spring Boot 4では、Spring Framework 7を土台に、次のような機能が加わりました。
自動設定のモジュール化
これまで spring-boot-autoconfigure という1つの大きなjarに入っていた自動設定が、spring-boot-webmvc や spring-boot-jdbc のように技術ごとのモジュールに分かれました。
それに合わせて、スターターも技術ごとになり、テスト用のスターター(spring-boot-starter-webmvc-test など)も用意されました。使わない機能の自動設定がクラスパスに入らないので、構成の見通しがよくなります。
Jackson 3
JSON処理のライブラリがJackson 3になりました。主な変化は次のとおりです。
- パッケージが
com.fasterxml.jacksonからtools.jacksonに変わった(@JsonPropertyなどのアノテーションは変わらない) - マッパーが、作成後に設定を変えられない
JsonMapperになった - 例外が非検査例外(RuntimeException)になった
- JSONの項目がアルファベット順になる、基本型(int など)へのnullがエラーになるなど、既定値が変わった(日付のISO-8601形式での出力は、Spring Bootでは以前から同じ)
特に既定値の変更は、APIのレスポンスの形が変わるので注意が必要です。
null安全(JSpecify)
「この値はnullになりうるか」を表すアノテーションが、Spring独自のものからJSpecifyに統一されました。
@NullMarked // このパッケージは「基本はnullではない」
package com.example.orders;
public @Nullable Order findByCode(String code) { ... }
IDEが「nullチェックをしていない」箇所を警告してくれるようになります。
APIバージョニング
REST APIのバージョン管理が標準機能になりました。
@GetMapping(version = "1.0")
public List<ProductV1> listV1() { ... }
@GetMapping(version = "2.0")
public List<ProductV2> listV2() { ... }
spring:
mvc:
apiversion:
use:
header: X-API-Version
バージョンは、ヘッダー・パス・クエリパラメータ・メディアタイプのいずれかで受け取れます。
HTTP Service Client
外部APIを、インターフェースを書くだけで呼び出せるようになりました。インターフェースの書き方自体はSpring Boot 3からありましたが、Spring Boot 4で登録と設定が自動化されました。
@HttpExchange("/v1/payments")
public interface PaymentClient {
@GetExchange("/{id}")
PaymentResult find(@PathVariable String id);
}
@SpringBootApplication
@ImportHttpServices(group = "payment", types = PaymentClient.class)
public class EcApplication { }
spring:
http:
serviceclient:
payment:
base-url: https://api.payment.example.com
リトライと同時実行数の制限
これまでSpring Retryなどの外部ライブラリが必要だったリトライが、Spring本体の機能になりました。
@Retryable(maxRetries = 3, delay = 200, multiplier = 2)
public PaymentResult pay(PaymentRequest request) { ... }
@ConcurrencyLimit(10)
public Report generateReport() { ... }
使うには、設定クラスに @EnableResilientMethods を付けます。
そのほかの変更
| 機能 | 内容 |
|---|---|
| OpenTelemetry Starter | 1つのスターターでメトリクスとトレースをOTLP形式で送れる |
| ヘルスチェックのプローブ | liveness と readiness がどの環境でも既定で有効 |
| RestTestClient | MockMvcと起動中のサーバーに同じ書き方でリクエストを送れる |
| Kotlin Serialization | KotlinのJSONライブラリを自動設定で使える |
移行で注意すべき点
Spring Boot 4では、3.xで非推奨だったAPIが削除されています。影響が大きいのは次の点です。
- スターター名の変更:
spring-boot-starter-webはspring-boot-starter-webmvcになった - スターターが必須になったもの:FlywayやRestClientは、専用のスターターを入れないと自動設定が効かない
- テスト:
@MockBeanは削除され、@MockitoBeanを使う - Jackson 3:既定値が変わるので、JSONを比べるテストが失敗しやすい
- 使えなくなったもの:組み込みサーバーのUndertow
移行は、まず3.5の最新版に上げて非推奨の警告を解消してから、4.0に進めるのが公式の推奨です。
まとめ
- Spring Boot 3は土台を刷新した世代、Spring Boot 4は土台を保ったまま整理・近代化した世代
- Javaの最低バージョンは17のままで、3.0のときほど大きな書き換えにはならない
- 4の主な新機能は、自動設定のモジュール化、Jackson 3、JSpecify、APIバージョニング、HTTP Service Client、リトライの内蔵
- 移行では、スターター名、テストのアノテーション、Jackson 3の既定値の変更に注意する
Spring Boot 4は、外部API呼び出しやAPI設計など、実務でよく書くコードが短く書けるようになっています。移行を検討するときの全体像として、参考にしてみてください。