目次
Spring Bootで構築された業務システムが、静かに老朽化している。1.x系はもちろん、2.x系もすでにOSSサポートが終了した。「動いているから問題ない」という判断が、セキュリティリスクと技術的負債を日々積み上げている。
Spring Boot 2.7のOSSサポートは2023年11月に終了している(出典:Spring Boot 2.7.18 available now)。商用の延長サポートも2024年内に期限を迎えた(出典:Spring Boot 2.7 Support Period Extended)。EOL後のバージョンには公式パッチが提供されない。新たなCVE(脆弱性)が発見されても、自力で対処するしかない状態だ。
本記事では、Spring Boot 1.x/2.x系のシステムを段階的にモダナイズする具体的な手順を解説する。
Spring Bootレガシーが抱えるモダナイゼーションの課題
「Spring Bootならまだ新しいのでは」と思う方もいるだろう。しかし、1.x系の初版リリースは2014年。2.x系でも2018年だ。10年近く稼働しているシステムは、フレームワーク以外の部分にも問題を抱えていることが多い。
サポート切れによるセキュリティリスク
2025年以降、Spring界隈では複数の重大な脆弱性が報告されている。Spring Cloud Gatewayにおける深刻度CriticalのCVEも含まれる(出典:Qiita「Spring界隈の脆弱性状況と2026年に向けた対策をまとめてみた」)。EOLバージョンにはこれらのパッチが提供されない。自社で独自にパッチを当てるか、脆弱性を放置するかの二択を迫られる。
Java 8依存という足かせ
Spring Boot 1.x/2.x系のシステムの多くがJava 8で動いている。Java 8自体の公式無償サポートはすでに終了しており、新しいライブラリやツールがJava 8を切り捨て始めている。開発者の採用面でも不利に働く。Java 8しか使えない現場に来たがるエンジニアは少ない。
依存ライブラリの連鎖的な陳腐化
Spring Boot本体だけでなく、周辺ライブラリも同時に古くなる。Hibernate、Jackson、Tomcatなど、Spring Bootが内部で利用している主要ライブラリも軒並みバージョンが古い。個別にアップデートしようとすると互換性の問題が連鎖的に発生する。結局、Spring Boot本体の移行なしには解決できない構造になっている。
Spring Boot 3.x移行で変わること
Spring Boot 3.xへの移行は単なるバージョンアップではない。技術スタックの世代交代を伴う。主要な変更点を整理する。
Java 17の必須化
Spring Boot 3.0以降はJava 17が最低要件となる(出典:Spring Boot 3.0 Migration Guide)。Record型、シールドクラス、テキストブロックといったモダンなJava機能が使える。コードの可読性が上がり、保守性も改善される。
Jakarta EE名前空間への移行
最大の破壊的変更が、javax.*からjakarta.*への名前空間の変更だ。javax.servletはjakarta.servletに、javax.persistenceはjakarta.persistenceに変わる(出典:Baeldung「Migrate Application From Spring Boot 2 to Spring Boot 3」)。
この変更はソースコード全体に影響する。import文だけでなく、設定ファイルやアノテーションの参照先もすべて書き換えが必要になる。数百ファイル規模のプロジェクトでは手作業での対応は現実的ではない。
GraalVM Native Imageへの正式対応
Spring Boot 3.xではGraalVM Native Imageが正式サポートされた(出典:Spring Boot公式ドキュメント「GraalVM Native Images」)。AOT(事前コンパイル)によって、起動時間の短縮とメモリ使用量の削減が可能になる。コンテナ環境やサーバーレス環境での運用に大きなメリットがある。
Spring Bootレガシーのモダナイゼーション|5段階の移行ステップ
一度にすべてを変えようとすると失敗する。段階を分け、各ステップで動作確認を行いながら進めるのが鉄則だ。
ステップ1: 現行システムの構造を可視化する
移行の第一歩は、現行システムの全体像を正確に把握することだ。Spring Bootアプリケーションは「設定より規約」の思想で構築されるため、明示的な設定ファイルが少ない。暗黙的な依存関係がコード全体に散らばっていることが多い。
具体的に把握すべき項目は以下のとおりだ。
- モジュール構成と依存関係の全体像
- 使用しているSpring Bootのスターター一覧
- 外部システムとの連携ポイント(API、DB、メッセージキュー)
- 自動構成(Auto Configuration)で有効になっている設定
- プロファイル別の環境設定
設計書が最新化されていない場合、ソースコードから構造を読み解く必要がある。この調査工程を省くと、移行中に想定外の依存関係が発覚し、手戻りが発生する。
ステップ2: Java 17へのアップグレード
Spring Boot 3.xに上げる前に、まずJavaのバージョンを17以上に引き上げる。Spring Boot 2.7はJava 17をサポートしているため、フレームワークを変えずにJDKだけを先行してアップグレードできる。
注意すべきポイントは3つある。
非推奨APIの除去。Java 9以降で削除されたAPIを使っている場合、コンパイルエラーが発生する。javax.xml.bind(JAXB)やjavax.activationは、Java 11で本体から除外された。依存ライブラリとして明示的に追加する必要がある。
リフレクション制限の強化。Java 16以降、内部APIへのリフレクションアクセスがデフォルトで制限される。--add-opensオプションで一時的に回避できるが、根本的にはコードの修正が望ましい。
ビルドツールの対応確認。Maven 3.8以上、Gradle 7.3以上が必要になる。CI/CDパイプラインも含めてビルド環境を更新する。
このステップ単体でテストを実施し、Java 17での動作を確認してから次に進む。
ステップ3: 依存ライブラリの整理とアップデート
Spring Boot本体を上げる前に、周辺ライブラリを可能な限り最新化しておく。具体的な対象は以下のとおりだ。
| カテゴリ | 主要ライブラリ例 | 確認事項 |
|---|---|---|
| ORM | Hibernate 5.x → 6.x | HQL構文の変更、型マッピングの確認 |
| セキュリティ | Spring Security 5.x → 6.x | 設定DSLの変更、認可モデルの刷新 |
| バリデーション | Hibernate Validator | Jakarta名前空間への対応状況 |
| HTTP通信 | RestTemplate → WebClient | 非推奨APIの置き換え検討 |
| テスト | JUnit 4 → JUnit 5 | アサーションAPIの変更 |
非推奨の機能やAPIを洗い出し、代替手段に置き換えておくことで、ステップ4での移行がスムーズになる。Spring Boot 2.7は3.xへの「踏み台」として設計されている。非推奨警告を丁寧に潰すことが、移行の成功率を左右する。
ステップ4: Spring Boot 3.xへのアップグレード
ここが本丸だ。Jakarta EEの名前空間変更を中心に、大量のコード修正が発生する。手作業で対応すると膨大な工数がかかるため、自動変換ツールの活用を強く推奨する。
OpenRewriteによる自動変換。OpenRewriteは、Javaソースコードのリファクタリングを自動化するツールだ。Spring Boot 3.x向けの移行レシピが公式に提供されている(出典:OpenRewrite「Migrate to Spring Boot 3.0」)。
Mavenプロジェクトの場合、pom.xmlにOpenRewriteプラグインを追加し、mvn rewrite:runを実行するだけで自動変換が走る。Gradleの場合はgradlew rewriteRunだ。主な自動変換の対象は以下のとおりである。
javax.*→jakarta.*のimport文一括変換- Spring Securityの設定DSL変更への対応
- プロパティファイルのキー名変更
- 非推奨API呼び出しの代替APIへの置き換え
自動変換の実行後、git diffで差分を確認し、変換漏れや意図しない変更がないかを検証する。自動変換ではカバーできない部分(カスタムアノテーションや独自のフィルタ実装など)は手動で修正する。
「移行対象の構造がわからない」が最大の障壁になっていないか。
SysDockは、AIマルチエージェントがSpring Bootのソースコードを解析し、モジュール構成・依存関係・外部連携をWord・PPT・React Flowフロー図で可視化する。ソースコード非送信、1週間納品、完全後払い。
ステップ5: モジュール構造の見直しと将来設計
Spring Boot 3.xへの移行が完了したら、アーキテクチャレベルの改善に着手する。ここで検討すべき選択肢が2つある。
選択肢A: モジュラーモノリスへの再構成。Spring Modulithを活用し、モノリスのまま内部構造をモジュール化する方法だ。Spring Modulith 2.0が2025年11月にGA版としてリリースされている(出典:Spring公式ブログ「Spring Modulith 2.0 GA released」)。
モジュール境界をパッケージ構造で明確にし、モジュール間の依存関係をテストで検証できる。マイクロサービスに比べて運用の複雑さが低く、段階的な移行の中間地点として有効だ。
選択肢B: マイクロサービスへの段階的分割。業務ドメインごとにサービスを切り出す方法だ。ストラングラーパターン(Strangler Fig Pattern)を適用し、既存のモノリスを稼働させながら、新しいサービスを一つずつ切り出していく。
いきなり全体をマイクロサービス化するのは危険だ。まずは独立性の高いドメイン(例:通知機能、レポート生成など)から切り出し、運用ノウハウを蓄積してから範囲を広げるのが現実的な進め方である。
Spring Bootモダナイゼーションで失敗しないための3つの原則
段階的に進めるとはいえ、押さえるべき原則がある。
原則1: テスト資産を先に整備する
モダナイゼーションの成否はテストの充実度で決まる。移行前のシステムにテストコードが不十分な場合、まず主要な業務フローのE2Eテストを整備する。既存の動作を保証するテストがあれば、移行後の回帰確認を自動化できる。テストなしの移行は、綱渡りと同じだ。
原則2: 一括移行を避け、段階リリースを徹底する
前述の5ステップは、それぞれ独立してリリース可能な単位になっている。Java 17への移行だけで一度本番にデプロイし、問題がないことを確認してから次のステップに進む。各ステップの間隔は1〜2スプリント程度が目安だ。問題の切り分けが容易になり、万一の切り戻しも限定的な範囲で済む。
原則3: 移行前に構造を「見える化」する
繰り返しになるが、構造の把握が移行の精度を決定する。Spring Bootの自動構成は便利だが、移行時には「何が暗黙的に設定されているか」が最大のリスク要因になる。@ConditionalOnClassや@ConditionalOnPropertyで制御されている設定は、ソースコードを読むだけでは全容がつかめない。
依存関係ツリーの出力(mvn dependency:tree)やActuatorのエンドポイント情報を活用し、暗黙的な設定を明示化しておくことが重要だ。
移行プロジェクトの費用感については、レガシーシステム移行の費用相場の記事で規模別・言語別に解説している。
まとめ
Spring Boot 1.x/2.x系のモダナイゼーションは、一度にすべてを変えるのではなく、段階的に進めることが成功の鍵だ。
本記事のポイントを整理する。
- Spring Boot 2.7のOSSサポートはすでに終了している。セキュリティパッチが提供されないリスクを、経営層にも正確に伝える必要がある。
- 移行は5段階で進める。構造の可視化 → Java 17化 → 依存ライブラリ整理 → Spring Boot 3.x化 → アーキテクチャ改善。各ステップで動作確認を挟むことで、リスクを最小化できる。
- OpenRewriteなどの自動変換ツールが、Jakarta EE移行の工数を大幅に削減する。ただし、自動変換だけでは完結しない。事前の構造把握と手動での検証作業が不可欠だ。
- 将来設計はSpring Modulithによるモジュラーモノリスも選択肢に入る。マイクロサービス化は段階的に進め、運用ノウハウを蓄積しながら範囲を広げるのが現実的である。
移行を始める前に、まず自社のSpring Bootシステムが「今どうなっているか」を正確に把握すること。その一歩が、プロジェクト全体の成功確率を大きく左右する。
Spring Bootシステムの構造、把握できているか。
SysDockは、AIマルチエージェントがソースコードからモジュール構成・依存関係・外部連携を自動解析し、Word・PPT・React Flowフロー図の3点セットで1週間納品する。Spring Bootを含む13言語/FWに対応。ソースコード非送信・完全後払いで、安心して依頼できる。
よくある質問(FAQ)
Q. Spring Boot 1.xから一気に3.xへ移行できますか?
A. 技術的には可能だが、推奨しない。1.x → 2.7 → 3.xの順で段階的に上げるのが安全だ。各バージョン間の非推奨警告を順番に解消していくことで、問題の切り分けが容易になる。OpenRewriteにも段階移行用のレシピが用意されている。
Q. 移行にかかる期間の目安は?
A. システム規模と既存コードの状態に依存する。小〜中規模のアプリケーション(数万行程度)であれば、1〜3ヶ月が目安だ。大規模なモノリスの場合は6ヶ月以上かかることもある。テストの充実度が期間を大きく左右する。
Q. OpenRewriteの自動変換だけで移行は完了しますか?
A. 機械的な変換(import文の書き換え、プロパティ名の変更など)は自動化できる。ただし、カスタムの設定クラスや独自のフィルタ実装、外部ライブラリとの互換性の問題は手動での対応が必要だ。自動変換でカバーできるのは全体の60〜70%程度と見込んでおくとよい。
Q. マイクロサービス化は必須ですか?
A. 必須ではない。Spring Modulithによるモジュラーモノリスも有力な選択肢だ。マイクロサービスは運用の複雑さ(分散トレーシング、サービス間通信、データ整合性など)が伴う。組織の運用体制と照らし合わせて判断すべきである。
現場改善に役立つ関連ツール
GenbaCompassでは、SysDock以外にも現場のDXを支援するツールを提供している。