0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【Spring Boot 4】Spring Boot 3と4は何が違うのか:比較表で押さえる世代の変化

0
Last updated at Posted at 2026-11-22

はじめに

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設計など、実務でよく書くコードが短く書けるようになっています。移行を検討するときの全体像として、参考にしてみてください。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?