Spring Boot 4は、2025年11月20日に4.0.0が出たSpring Bootのメジャーバージョンです。2026年10月時点の最新は4.1.1(2026年8月20日公開)で、次の4.2.0は11月に予定されています。基盤がSpring Framework 7とJakarta EE 11に上がり、JSONライブラリはJackson 3が既定になりました。モジュールも細かく分割されたため、移動・削除されたクラスを参照する3系のコードは、そのまま上げるとコンパイルエラーになります。
この記事では、最新バージョンとサポート期限、4.0の変更点と新機能、4.1で増えた機能、Javaなどのシステム要件を公式のリリースノートで確認したうえで、Spring Boot 3.5.16で動いていたアプリを4.1.1へ上げたときに実際に落ちた箇所と直し方を示します。Spring Bootそのものの仕組みと最小構成はSpring Bootとは|4.1系の依存名の変更と最小Web APIの作り方で扱っています。
まとめ:Spring Boot 4の最新バージョンと変更点の要点
- 最新の安定版は4.1.1(2026年8月20日)。4.0系の最新は4.0.8、3系の最新は3.5.16です。4.2.0は2026年11月に予定されています。
- 4.0の変更の中心は基盤とモジュールの刷新です。Spring Framework 7・Jakarta EE 11・Servlet 6.1に上がり、starterの一部が改称され、JSONはJackson 3(パッケージは
tools.jackson)が既定になりました。 - 3.xで非推奨だったAPIは4.0で削除されました。
@MockBean、Undertow、実行可能jarの起動スクリプトなどが使えません。 - Javaは17以上で、4.1.1は26まで対応します。最低要件は3系と同じなので、JDKを上げずに移行できます。
- 3.5のOSSサポートは2026年6月30日で終了済み、4.0も2026年12月31日に終わります。これから選ぶなら4.1です。
- 3.5.16の最小アプリを4.1.1へ上げると、本体のコンパイル(Jackson)、テストのコンパイル(
@MockBeanとTestRestTemplate)、テスト実行時(依存の不足)の3段で止まりました。
Spring Bootの最新バージョンは4.1.1(2026年10月時点)
2026年10月14日時点でMaven Centralに公開されている各系列の最新版は次のとおりです。4.1.1はバグ修正・ドキュメント改善・依存更新を合計98件含むパッチで、Spring公式ブログの4.1.1リリース告知で公開されました。4.2.0はマイルストーン版の4.2.0-M2まで出ています。
| 系列 | 最新版 | 公開日 | OSSサポート終了 | 商用サポート終了 |
|---|---|---|---|---|
| 4.2 | 4.2.0-M2(開発中) | GAは2026年11月予定 | 2027/12/31 | 2028/12/31 |
| 4.1 | 4.1.1 | 2026/8/20 | 2027/7/31 | 2028/7/31 |
| 4.0 | 4.0.8 | 2026/8/20 | 2026/12/31 | 2027/12/31 |
| 3.5 | 3.5.16 | 2026/6/25 | 2026/6/30(終了) | 2032/6/30 |
| 3.4 | 3.4.13 | – | 2025/12/31(終了) | 2026/12/31 |
サポート期限はSpringの公式APIが返す世代表(Spring Bootプロジェクトページのサポート欄と同じデータ)の値です。2.x以前を含む全世代の一覧はSpring Bootバージョン一覧とサポート期限(EOL)にまとめています。
サポート期限とリリースの周期:LTSは無く、マイナーは半年ごと
Spring Bootはおおむね半年ごとにマイナーバージョンを出し(3.5は2025年5月、4.0は11月、4.1は2026年6月)、各マイナーに最低13か月の無償サポート(OSSサポート)が付きます。4.1は2026年6月10日の公開でOSS終了が2027年7月31日なので、約13か月半です。JavaのようなLTS版の指定は無く、長く同じ版にとどまりたい場合は有償の商用サポートを使うことになります。3.5の商用サポートだけが2032年まで長いのは、3系の最終マイナーとして延長されているためです。
4系のパッチは2026年に4月23日・6月10日・8月20日とおよそ2か月おきに出ています。次の4.1.2・4.0.9と4.2.0-RC1は、GitHubのマイルストーン上の期日が2026年10月22日です。
使っているSpring Bootのバージョンを確認する方法
Mavenならspring-boot-starter-parentのversion、Gradleならpluginsブロックのid 'org.springframework.boot' version '4.1.1'がそのプロジェクトの版です。次のコマンドは、spring-boot-starter-parentを直接の親POMに指定した構成で使います。独自の親POMやBOMのインポートを使う構成では、解決されたSpring Boot依存の版を確認してください。
mvn -q help:evaluate -Dexpression=project.parent.version -DforceStdout
# 4.1.1
mvn -q help:evaluate -Dexpression=spring-framework.version -DforceStdout
# 7.0.9
-Dexpression=spring-boot.versionでは、この検証構成では値が取れません(starter-parentがそのプロパティを定義していないため)。プロジェクト側で同名のプロパティを定義している場合は取得できます。実行中のアプリからはorg.springframework.boot.SpringBootVersion.getVersion()で取得できます。
Spring Boot 4.0の主な変更点とSpring Boot 3.5との違い
4.0は、javaxからjakartaへ移った3.0以来の大きな改訂です。名前空間の一斉置換は要りませんが、周辺のSpringプロジェクトもそろってメジャーバージョンが上がります。一次情報はSpring Boot 4.0 Release NotesとSpring Boot 4.0 Migration Guideです。
3.5.16と4.1.1で管理される依存の版の比較
同じspring-boot-starter-webとspring-boot-starter-testだけのプロジェクトで、Mavenのdependency:listが解決した版を並べました。
| 項目 | Spring Boot 3.5.16 | Spring Boot 4.1.1 |
|---|---|---|
| Spring Framework | 6.2.19 | 7.0.9 |
| Jakarta EE / Servlet | EE 10 / 6.0 | EE 11 / 6.1 |
| 組み込みTomcat | 10.1.55 | 11.0.24 |
| Jackson(databind) | 2.21.4 | 3.1.5 |
| JUnit Jupiter | 5.12.2 | 6.0.3 |
| Mockito | 5.17.0 | 5.23.0 |
| 対応Java | 17〜25 | 17〜26 |
| Undertow | 使える | 削除 |
4.0.0の時点で、Spring Security 7.0、Spring Data 2025.1、Spring Batch 6.0、Hibernate 7.1.8.Final、Kotlin 2.2.21にも上がっています。テストの既定はJUnit 6になり、JUnit 4のテストを残すならjunit-vintage-engineを自分で追加します。JUnitの書き方はJUnitとは?Javaの単体テストフレームワークの基本と書き方を参照してください。
モジュール化とstarterの改称:旧名が残るものと消えたもの
4.0では、自動構成をまとめていた大きなjarがspring-boot-<技術名>という小さなモジュールに分かれ、パッケージもorg.springframework.boot.<技術名>に移りました。starterを使っていれば依存はほぼそのままですが、改称されたstarterは扱いが分かれます。
| 3系の名前 | 4系の名前 | 旧名の扱い |
|---|---|---|
| spring-boot-starter-web | spring-boot-starter-webmvc | 非推奨で残る |
| spring-boot-starter-web-services | spring-boot-starter-webservices | 非推奨で残る |
| spring-boot-starter-oauth2-client | spring-boot-starter-security-oauth2-client | 非推奨で残る |
| spring-boot-starter-oauth2-resource-server | spring-boot-starter-security-oauth2-resource-server | 非推奨で残る |
| spring-boot-starter-aop | spring-boot-starter-aspectj | 4系には無い |
| spring-boot-starter-tomcat(war配備) | spring-boot-starter-tomcat-runtime | 差し替えが必要 |
Maven Centralで確認すると、spring-boot-starter-webは4.1.1にも公開されていて、説明文に「deprecated in favor of spring-boot-starter-webmvc」と付いています。一方spring-boot-starter-aopは4.0.0から公開が無く、明示的に書いていると依存解決の段階で失敗します。移行ガイドは、AspectJの注釈を本当に使っているかを確認してからspring-boot-starter-aspectjへ替えるよう求めています。starter名の詳しい変化はSpring MVCとは?spring-webmvcの役割とSpring Boot 4での依存名変更で扱っています。
依存を細かく直す前にまず起動させたい場合は、spring-boot-starter-classicとspring-boot-starter-test-classicを使えます。全モジュールを含みつつ推移的依存を除いた移行用のstarterで、公式は最終的に外すことを推奨しています。
Jackson 3が既定に:パッケージと設定の変更点
4.0のJSON処理はJackson 3が既定です。グループIDとパッケージはcom.fasterxml.jacksonからtools.jacksonに変わりました。例外として、注釈のjackson-annotationsはcom.fasterxml.jackson.annotationのままなので、@JsonPropertyなどのimportは書き換え不要です。
- 自動構成されるのは
ObjectMapperではなくJsonMapperです。差し替えたいときもJsonMapper型のBeanを定義します。 Jackson2ObjectMapperBuilderCustomizerはJsonMapperBuilderCustomizerに、@JsonComponentは@JacksonComponentに改称されました。- JSON固有の
spring.jackson.read.*とspring.jackson.write.*は、4.0でspring.jackson.json.read.*とspring.jackson.json.write.*に移りました。4.1では、JSON・XML・CBORに共通する設定としてspring.jackson.read.*が別の意味で戻っています。 - Jackson 3の
JacksonExceptionは非検査例外です。catch (IOException e)でパースエラーも拾っていたコードは、例外が素通りするようになります。 - 3系の既定にできるだけ合わせたい場合は
spring.jackson.use-jackson2-defaults=trueを設定します。Jackson 2を使い続けるためのspring-boot-jackson2は非推奨の暫定モジュールです。
JerseyはJackson 3に未対応なので、Jerseyを使うアプリではspring-boot-jackson2を併用します。Jackson 2と3の既定値の違いはJacksonをMavenで導入する手順|2.22と3.2の依存の違いで実測しています。
4.0で削除された機能
3.xで非推奨だったクラス・メソッド・プロパティに加え、次の機能が削除されました。
- Undertow:Servlet 6.1に未対応のため、starterごと削除。組み込みサーバーはTomcat 11.0かJetty 12.1を選びます。
- @MockBeanと@SpyBean:Spring Frameworkの
@MockitoBeanと@MockitoSpyBeanに置き換えます。新しい注釈はテストクラスのフィールドでは使えますが、@Configurationクラスでは使えません。 - 実行可能jarの起動スクリプト:
./app.jarのように直接実行するjarは作れません。java -jarで起動します。 - classicローダー:ビルド設定の
loaderImplementationの指定は削除が必要です。 - Spring Retryの依存管理:使い続けるなら版を自分で指定します。公式はSpring Framework 7のリトライ機能への移行を勧めています。
- Spring Session HazelcastとMongoDB、Pulsar Reactive、Spock連携:Spockは4.1で復活しました。
既定値が変わった設定:上げただけで挙動が変わる箇所
コンパイルは通るのに動きが変わる箇所は見落としやすいので、移行ガイドから拾っておきます。テストでは、@SpringBootTestだけではMockMvcも提供されなくなり、@AutoConfigureMockMvcが必要です。
| 対象 | 3.5まで | 4.0から |
|---|---|---|
| Actuatorのliveness・readiness | Kubernetes上だけ有効 | 常に有効 |
| DevToolsのLiveReload | 有効 | 無効 |
| @SpringBootTestのTestRestTemplate | 自動で注入 | 注釈と依存の追加が必要 |
| Mavenのoptional依存 | uber jarに含む | 含まない |
| Jacksonのモジュール登録 | 既知のものだけ | クラスパス上を全部 |
| war配備時のforward-headers-strategy | 効く | 効かない |
RestTemplateも、自動構成されるRestTemplateBuilderがspring-boot-restclientモジュールへ分離されました。使い続けるならspring-boot-starter-restclientを追加します。RestClientへの移り方はSpringのRestClientとは?使い方とRestTemplate非推奨後の移行で説明しています。
Spring Boot 4.0で追加された新機能(コード例つき)
4.0の新機能の多くはSpring Framework 7で入り、Spring Bootが自動構成と設定プロパティを用意した形です。Spring Framework 7.0 Release Notesと合わせて読むと全体がつかめます。
APIバージョニング:ヘッダーで振り分ける例
Spring MVCとWebFluxで、APIのバージョンによる振り分けが標準機能になりました。設定はspring.mvc.apiversion.*プロパティで行い、コントローラーでは@GetMappingのversion属性に版を書きます。次のコードは4.1.1で動かし、ヘッダーなしと1.0はv1、2.0はv2、定義していない3.0は400 Bad Requestになることを確認しました。
# application.properties
spring.mvc.apiversion.use.header=API-Version
spring.mvc.apiversion.default=1.0
この例は、Spring Boot 4.1.1のWeb MVCアプリに追加するコードです。コントローラーをコンポーネントスキャンの対象パッケージに置き、次のimportを追加します。
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
class UserController {
@GetMapping(path = "/users", version = "1.0")
String v1() { return "v1"; }
@GetMapping(path = "/users", version = "2.0")
String v2() { return "v2"; }
}
パスやクエリパラメーター、メディアタイプで版を受け取ることもできます。細かく制御したいときはApiVersionResolverなどのBeanを定義します。バージョニングの設計そのものはバージョニングとは?セマンティック/APIバージョニングの意味と運用設計で扱っています。
リトライと同時実行制限:Spring Retryなしで書ける@Retryable
Spring Framework 7は、Spring Retryの機能を整理して本体に取り込みました。@EnableResilientMethodsを付けると、org.springframework.resilience.annotationパッケージの@Retryableと@ConcurrencyLimitが使えます。次の例は2回失敗して3回目に成功するメソッドです。別のBean(検証ではコントローラー)に注入したFlakyClientのcall()を4.1.1で呼ぶと、呼び出し元にok after 3が返りました。カウンターはBeanが保持するので、この結果になるのはアプリ起動後の初回呼び出しです。
import java.util.concurrent.atomic.AtomicInteger;
import org.springframework.context.annotation.Configuration;
import org.springframework.resilience.annotation.EnableResilientMethods;
import org.springframework.resilience.annotation.Retryable;
import org.springframework.stereotype.Component;
@Configuration
@EnableResilientMethods
class ResilienceConfig {
}
@Component
class FlakyClient {
private final AtomicInteger count = new AtomicInteger();
@Retryable(maxRetries = 3, delay = 100)
String call() {
int n = count.incrementAndGet();
if (n < 3) {
throw new IllegalStateException("fail " + n);
}
return "ok after " + n;
}
}
maxRetriesは最初の呼び出しを含まない再試行の回数です。@Recoverまで使っている場合の判断はSpring Retryの依存関係と@Retryable/@Recover実装で整理しています。
HTTPクライアントの自動構成・null安全性・テストAPIの変更点
- HTTP Service Clients:
@HttpExchangeを付けたインターフェースから外部APIを呼び出す仕組みに、Spring Boot 4.0で自動構成と設定プロパティのサポートが加わりました。 - JSpecifyのnull注釈:Spring Boot全体にJSpecifyの注釈が付きました。Kotlinやビルド時のnullチェッカーを使っていると、型のnull許容が変わってコンパイルエラーになる場合があります。
org.springframework.lang.Nullableはorg.jspecify.annotations.Nullableへ移行します。 - RestTestClient:MockMvcにも実サーバーにも同じ書き方でリクエストを送れるテスト用クライアントで、
TestRestTemplateの後継です。 - ほかに
JmsClientの自動構成、spring-boot-starter-opentelemetry、Beanを手続き的に登録するBeanRegistrarが加わりました。
Spring Boot 4.1の新機能と4.0から上げるときの注意
4.1.0は2026年6月10日に公開されました。内容はSpring Boot 4.1 Release Notesにまとまっています。4.0ほどの大改訂ではありませんが、gRPCとセキュリティ関連が増えました。
- gRPC:gRPCのサーバーとクライアントを公式に扱えるようになりました。Nettyの単独サーバーと、Servlet上でHTTP/2として公開する方法の両方を選べます。
- SSRF対策のInetAddressFilter:HTTPクライアントに
InetAddressFilterを設定して、特定アドレスへの送信を止められます。ユーザーが入力したURLを取得する機能に向きます。 - JDBC接続の遅延取得:
spring.datasource.connection-fetch=lazyにすると、SQL文を実際に発行するまでプールから接続を取りません。 - Log4jのファイルローテーション:size・time・size-and-time・cronの4方式を設定できます。
- ほかに、
spring.config.importでの文字コード指定、Spring BatchのMongoDB対応、@RedisListenerの自動構成が加わりました。
4.0から4.1へ上げるときは、4.0で非推奨だったAPIが削除される点に注意します。とくに次の3つはビルドや運用の手順に響きます。
- 非推奨だった
layertoolsのjarモードが削除されました。Dockerfileで-Djarmode=layertoolsを使っているなら-Djarmode=toolsへ替えます。 - Mavenで
-DskipTestsを付けても、テストのAOT処理は飛ばなくなりました。止めるには-Dmaven.test.skip=trueを使います。 - jOOQの対応版が3.20になり、jOOQを使うアプリはJava 21以上が必要です。Apache DerbyとDevToolsのLiveReloadは非推奨になりました。
Spring Boot 4のシステム要件(Java・Tomcat・Gradle)
Spring Bootのシステム要件ページによると、4.1.1と4.0.8の要件は次のとおりです。
| 項目 | 4.1.1・4.0.8の要件 |
|---|---|
| Java | 17以上・26まで対応 |
| Spring Framework | 7.0.9以上 |
| Kotlin | 2.2以上 |
| Maven | 3.6.3以上 |
| Gradle | 8.14以上の8.x、または9.x |
| 組み込みサーバー | Tomcat 11.0.x、Jetty 12.1.x(Servlet 6.1) |
| GraalVM Native Image | GraalVM 25以上 |
Java 17のままでも動きますが、移行ガイドは最新のLTS版を使うよう勧めています。2026年10月時点のLTSはJava 25です。2026年9月に出たJava 27には、4.1.1はまだ対応していません。外部のアプリケーションサーバーにwarで配備する場合もServlet 6.1以上が前提で、公式はServlet 6.1未対応のコンテナ(Tomcat 10.1など)への配備を推奨していません。Java 21と25の違いはJava 21と25の違い|正式化した新機能・サポート期限・移行で止まる箇所で比較しています。
Spring Boot 3.5から4.1へ上げて実際に落ちた箇所
2026年10月14日に、Temurin JDK 25.0.4.1+1とMaven 3.9.11で検証しました。3.5.16で全テストが通る最小のアプリのspring-boot-starter-parentの版だけを4.1.1に変えています。アプリはObjectMapperをコントローラーに注入してJackson2ObjectMapperBuilderCustomizerで設定を足し、テストは@MockBeanとTestRestTemplateで書いた、3系では標準的な構成です。
| 段階 | 出たエラー | 直し方 |
|---|---|---|
| 1 本体のコンパイル | パッケージcom.fasterxml.jackson.databindが無い | tools.jackson.databindへ |
| 1 本体のコンパイル | org.springframework.boot.autoconfigure.jacksonが無い | JsonMapperBuilderCustomizerへ |
| 2 テストのコンパイル | org.springframework.boot.test.mock.mockitoが無い | @MockitoBeanへ |
| 2 テストのコンパイル | org.springframework.boot.test.web.clientが無い | spring-boot-resttestclientを追加 |
| 3 テストの実行 | NoClassDefFoundError: RestTemplateBuilder | spring-boot-restclientを追加 |
3段目は気付きにくい落とし穴です。spring-boot-resttestclientを足すとコンパイルは通りますが、テストを起動するとorg.springframework.boot.restclient.RestTemplateBuilderが見つからずにアプリの起動自体が失敗しました。移行ガイドにも、TestRestTemplateにはspring-boot-restclientの実行時依存が要ると書かれています。最終的にテストへ足した変更は次のとおりです。
<!-- pom.xml(テスト用に追加) -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-resttestclient</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-restclient</artifactId>
<scope>test</scope>
</dependency>
import org.springframework.boot.resttestclient.TestRestTemplate;
import org.springframework.boot.resttestclient.autoconfigure.AutoConfigureTestRestTemplate;
import org.springframework.test.context.bean.override.mockito.MockitoBean;
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
@AutoConfigureTestRestTemplate
class HelloTests {
@MockitoBean GreetingService service;
@Autowired TestRestTemplate rest;
}
逆に、変えなくても動いたものもあります。spring-boot-starter-webは非推奨のまま解決され、recordを返すエンドポイントのJSON(項目の順序と日付の書式)は3.5.16と同じ出力でした。今回の構成では、表に挙げた5つの対応が必要でした。既存テストで旧パッケージや削除された注釈を広く使っている場合は、テストコードと依存設定の修正範囲が広がります。
移行の進め方と、急がない方がよいケース
公式の手順は、まず3.5系の最新パッチ(3.5.16)に上げ、非推奨APIの警告を消してから4.0系の最新パッチへ上げる流れです。4.1は4.0で非推奨だったAPIをさらに削除するので、規模の大きいアプリでは4.0.8を経由し、そこで出た警告も消してから4.1.1へ進むと切り分けが楽です。
- 3.5.16に上げ、コンパイル時の非推奨警告をなくす
- Spring Cloudなど、Spring Bootが版を管理していない依存の互換版を確認する
- 親POMを4.0.8に上げ、
spring-boot-properties-migratorを実行時依存に足して、改名されたプロパティを起動時のログで洗い出す - 止まったら
spring-boot-starter-classicで一旦動かし、importを直してから外す - 4.1.1に上げ、最後にproperties-migratorを外す
次の条件が4系への移行を妨げている場合は、準備ができるまで3.5の商用サポートを利用する判断もあります。4.0にも同じ制約があるため、4.0への移行では解消しません。組み込みサーバーにUndertowを使っている、JerseyでJSONを扱っている、自作のstarterを3系と4系の両方で配っている(公式は同一成果物での両対応を強く非推奨としています)、のいずれかです。商用サポートを契約せずに、OSSサポートが切れた3.5を本番で使い続けることは避けてください。Javaのバージョンアップと合わせた移行の段取りはJavaマイグレーションの進め方|JDK 8→21/25の手順とSpring Boot・Jakarta移行で解説しています。業務システム全体の移行を外部に任せたい場合は、一想のシステムマイグレーション・リプレイスでも相談を受け付けています。
よくある質問
Spring Boot 4にLTS(長期サポート版)はありますか?
ありません。どのマイナーも無償サポートは最低13か月で、それより長く使うなら有償の商用サポートを契約します。4.1の無償サポートは2027年7月31日までです。
Spring Boot 4はJava 17で動きますか?
動きます。4.1.1の要件はJava 17以上で、Java 26まで対応しています。最低要件は3系と同じなので、JDKとSpring Bootの更新を別々に進められます。新規なら公式が勧める最新LTSのJava 25を選びます。
Spring Boot 4で使えるTomcatのバージョンは?
組み込みはTomcat 11.0.xで、4.1.1が管理する版は11.0.24です。Servlet 6.1が前提なので、warを外部のTomcatに配備する場合もTomcat 11以上を選びます。Servlet 6.0のTomcat 10.1への配備は公式が推奨していません。
Spring Boot 4でUndertowは使えますか?
使えません。UndertowがServlet 6.1に未対応のため、4.0でstarterごと削除されました。Undertowを使っているアプリは、移行前にTomcatかJettyへの切り替えが必要です。
Spring Boot 4でRestTemplateBuilderが見つからないのはなぜですか?
4.0でspring-boot-restclientモジュールへ分離され、パッケージもorg.springframework.boot.restclientに変わったためです。本番コードならspring-boot-starter-restclientを追加します。TestRestTemplateを使うテストで出た場合は、spring-boot-restclientを実行時に参照できるようにしてください。