Spring Boot 4 と Spring Framework 7:高速で安全なマイクロサービスのための Java の新時代
自分で持っている小さなサービスが、Spring Boot 3 で 2 年ほど動いている。大したものじゃない。2 つのプロバイダから情報を取ってきて Postgres に格納し、JSON を返す API。日曜の午後に結局自分がメンテすることになる、ありがちな退屈なサービスだ。
11 月 13 日に Spring Framework 7.0 が出た。20 日に Spring Boot 4.0 が出た。21 日の金曜日、朝のコーヒーと一緒に移行用ブランチを切った。
サービスが急に必要としていたからではない。正直な答えを出したかったのだ。今回のバージョンでどれだけが本当の変化で、どれだけがリリースノートの目録なのか。2 日経った今、分かったことを書く。
OpenRewrite が直したものと、自分に残されたもの
最初に動かしたのはコミュニティレシピ org.openrewrite.java.spring.boot4.UpgradeSpringBoot_4_0。「コミュニティ」の部分は強調しておきたい。Spring チームは保守しておらず、それは端々で分かる。
ひと午後でビルドは通るようになった。依存関係を上げ、Jackson 3 へ移行し(Jackson 3 がデフォルト。Jackson 2 は非推奨のブリッジで、自動検出が 7.1 で無効になり 7.2 で消える)、yaml のプロパティもいくつかリネームしてくれた。
面白かったのは、直らなかった部分だ。Undertow はもうサポートされない。Undertow を使っていたら Tomcat か Jetty に引っ越すしかない。スターターはモジュール化されて、spring-boot-starter-web は spring-boot-starter-webmvc として応答する。自分のケースではリネームだけでしたが、独自スターターを持つプロジェクトは腰を据えて見直す必要がある。それと TestRestTemplate は別出しになった。専用のテスト依存関係が要る。新しく書くものには RestTestClient があり、おまけに型もまともにつく。
コンパイルが緑であることと、動くことは別問題だ。その部分は今も自分の仕事のまま。
午前 3 時の NPE
しばらく前、あるプロバイダが無断で API を変えてきて、開発では一度も空だったことのないフィールドが本番で null で届き始めた。サービスは午前 3 時に落ちた。アラートで起こされた。それ以来、null を宣言しない API は何であれ信用していない。
だから Framework 7 の新機能の中で一番興味があるのは JSpecify だ。Google、JetBrains などが合同で作った標準で、Spring はポートフォリオ全体で採用した。IntelliJ と Eclipse はすでに理解する。自分のコードに取り入れる一番安い方法は package-info.java だ:
// src/main/java/com/zademy/service/package-info.java
@org.jspecify.annotations.NullMarked
package com.zademy.service;これでパッケージ全体がデフォルトで non-null になる。欠けうるものには @Nullable を付けると、IDE がタイピングしている最中に警告してくれる。本番でポケットベルを鳴らされながら気づくのではなく。あの早朝、これがあればもっと安く済んだ。移行の半分はこの変更だけで正当化される。
宣言的な HTTP クライアント
Framework 7 のリファレンスドキュメントはすでに RestTemplate を非推奨としている。@Deprecated アノテーションは 7.1 で入る。つまり今日爆発するわけではないが、道は書かれているので、歩き始める価値はある。
自然な置き換えは、私にとって @HttpExchange の宣言的クライアントだ。以前は OpenFeign とその依存関係が必要だった。今はフレームワークの中にある:
@HttpExchange("/api/products")
public interface ProductClient {
@GetExchange("/{id}")
Product getProduct(@PathVariable("id") String id);
@GetExchange
List<Product> listProducts();
@PostExchange
Product createProduct(@RequestBody Product product);
}定義するのは「何を呼ぶか」で、「どう呼ぶか」ではない。インターフェースなのでテストでのモックも簡単だ。いつかリアクティブ版が必要になったら、@ImportHttpServices の clientType で RestClient と WebClient を切り替えられる。インターフェースには触らずに済む。
前からあったものと、本当に新しいもの
ここからは懐疑的な面が出る。バージョン 4 の新機能として祝われているもののいくつかは、新しくない。JdbcClient は快適に使えるが、Framework 6.1 からあるものだ。@Observed は Boot 3 からあった。Micrometer は 1.16 で Tracing が 1.6 であり、どこかで繰り返し読んだ架空の 2.0 ではない。本当に新しいのは公式の OpenTelemetry スターターだ。
本当に新しいものを挙げるなら、spring-context のネイティブレジリエンス。@Retryable、@ConcurrencyLimit、@EnableResilientMethods が外部依存なしで使える。それと API バージョニングがついに宣言的に。@RequestMapping の version 属性と、戦略を選ぶ spring.mvc.apiversion.*。この 2 つは私のブランチで居場所を勝ち取った。
要件について。Java 17 が下限で、Java 25 までサポート(推奨の LTS)、Kotlin 2.2、GraalVM 25、そして Servlet 6.1、JPA 3.2、Bean Validation 3.1 を含む Jakarta EE 11 に完全対応。パフォーマンスについては、自動設定をモジュールに分割したおかげで起動が速くなるという触れ込み。自分ではベンチマークを走らせていないし、他人のベンチマークには疲れている。なのでそれは借りとして残す。この触れ込みを繰り返す前に、実サービスで測る。
証明書の未遂インシデント
もうひとつ忘れられない怖い目がある。プロバイダの証明書が土曜日に切れたやつだ。気づいたのはユーザーが連絡してくれたからで、何かが知らせてくれたからではない。
ブランチでは Actuator の証明書チェックを設定した。期限が近づくと、インシデントになる前に health エンドポイントが報告してくれる。これのために移行したわけではないが、ここ数日で設定したものの中で、一番落ち着きを返してくれたのはこれだ。未遂のインシデントは changelog より多くを教えてくれる。
今のところの結論
新規プロジェクト: 迷わず yes。今後数年の基盤の上から始めるのは理にかなっているし、.0 のささくれはそのうち削れていく。このノートは GA の数日後に書いていて、パッチ番号はあえて引用していない。読む頃には 4.0.x は前へ進んでいるはずだ。
動いているプロジェクト: 慣性で移行しないこと。Jackson 3 が要る、バージョン付き API が要る、レジリエンスの依存を減らしたい、といった実際の引き金を待つ。差し迫っていないなら、Boot 3 は明日落ちたりしない。
私のブランチは半分だ。コンパイルは通り、テストの大半は通り、残りは結合テストと、リリースノートと照らし合わせてプロパティの変更をひとつずつ見直すこと。ひと午後では済まなかった。「すぐ終わる」と言う人がいたら、その人は実際にやっていない。だが、このブランチから出てくるサービスは保守が楽になる。今のところは、それで十分だ。