322-frameworks-spring-boot-testing-integration-tests

Spring Boot 統合テスト

Spring Boot 4.0.x 向けの統合テストのガイドラインを適用します。

このスキルで扱う内容

• 統合テストの範囲と目的（ユニットテストの重複ではなく、配線とコントラクトを検証する）
• 設定不要の配線を実現する Testcontainers と @ServiceConnection（推奨）
• 組み込みのサービス接続に対応していないコンテナーのフォールバックとしての @DynamicPropertySource
• パフォーマンス向上のため、テストメソッド間で共有される静的な @Container インスタンス
• 流暢な AssertJ ベースの HTTP アサーションを行う MockMvcTester（Spring Boot 4.0.x）
• HTTP スタック全体をテストする TestRestTemplate
• @DataJdbcTest / @DataJpaTest の永続化スライス（永続化レイヤーのみを読み込み、起動を高速化）
• データの分離：各テストがそれぞれのシナリオを所有し、変更可能な状態の共有や実行順序への依存を避ける
• モック登録のための @MockitoBean（Spring Boot 4.0.x — @MockBean は削除済み）
• リソースのライフサイクル：終了処理には Testcontainers の JUnit 統合を使用し、*IT と統合テストを分離する

範囲： リファレンスのルールと良い／悪いコード例に基づいて推奨事項を適用します。

制約

統合テストに変更を加える前に、プロジェクトがコンパイルできることを確認してください。コンパイルに失敗した場合は、直ちに作業を中止してください。改善を適用した後は、完全な検証を実行してください。

• 必須：変更を適用する前に ./mvnw compile または mvn compile を実行する
• 安全性：コンパイルに失敗した場合は、直ちに作業を中止する
• 検証：改善を適用した後に ./mvnw clean verify または mvn clean verify を実行する
• 適用前：詳細なルールと良い／悪いパターンについて、リファレンスを読む
• エッジケース：依頼の範囲が曖昧な場合は、変更を適用する前に作業を中止して確認する
• エッジケース：必要な入力、ファイル、ツールが不足している場合は、不足しているものを報告し、セットアップの案内を進めてよいか確認する

このスキルを使用する場面

• Spring Boot の統合テストに関する Java コードをレビューする
• Java コードで Spring Boot の統合テストのベストプラクティスを適用する
• Testcontainers を使用した @SpringBootTest 統合テストを作成する
• Spring 統合テスト向けの動的プロパティを設定する
• Spring Boot 統合テストのプロファイルをレビューする

ワークフロー

1. リファレンスを読み、プロジェクトのコンテキストを確認する

references/322-frameworks-spring-boot-testing-integration-tests.md を読み、変更を提案する前に現在のプロジェクト設定を確認します。

2. 範囲を把握し、改善対象を決める

依頼された成果、制約、適用する変更のうち安全性を確保できる最小限のものを特定します。

3. フレームワークに沿った変更を適用する

リファレンスのパターンとプロジェクトの規約に従って、設定やコードを実装またはリファクタリングします。

4. 検証を実行し、結果を報告する

適切なビルド／テストを実行し、変更内容、検証した内容、追加の対応事項をまとめます。

リファレンス

詳細なガイダンス、例、制約については、references/322-frameworks-spring-boot-testing-integration-tests.md を参照してください。