Spring Boot テスト

このスキルは、モダンなパターンとベストプラクティスを用いた Spring Boot 4 アプリケーションのテストに関する専門的なガイドを提供します。

コア原則

1. テストピラミッド: ユニット (高速) > スライス (フォーカス) > 統合 (完全)
2. 適切なツール選択: 信頼性を得られる最小限のスライスを使用する
3. AssertJ スタイル: 冗長なマッチャーより流暢で読みやすいアサーション
4. モダン API: 従来の代替品より MockMvcTester と RestTestClient を優先

どのテストスライスを選ぶ?

シナリオ	アノテーション	リファレンス
コントローラー + HTTP セマンティクス	@WebMvcTest	references/webmvctest.md
リポジトリ + JPA クエリ	@DataJpaTest	references/datajpatest.md
REST クライアント + 外部 API	@RestClientTest	references/restclienttest.md
JSON (逆)シリアライズ	@JsonTest	references/test-slices-overview.md
完全なアプリケーション	@SpringBootTest	references/test-slices-overview.md

テストスライス リファレンス

• references/test-slices-overview.md - 決定マトリックスと比較
• references/webmvctest.md - MockMvc を使用した Web レイヤー
• references/datajpatest.md - Testcontainers を使用したデータレイヤー
• references/restclienttest.md - REST クライアントテスト

テストツール リファレンス

• references/mockmvc-tester.md - AssertJ スタイルの MockMvc (3.2+)
• references/mockmvc-classic.md - 従来の MockMvc (3.2 以前)
• references/resttestclient.md - Spring Boot 4+ REST クライアント
• references/mockitobean.md - 依存関係のモック化

アサーションライブラリ

• references/assertj-basics.md - スカラー、文字列、ブール値、日付
• references/assertj-collections.md - リスト、セット、マップ、配列

Testcontainers

• references/testcontainers-jdbc.md - PostgreSQL、MySQL など

テストデータ生成

• references/instancio.md - 複雑なテストオブジェクトを生成 (3 以上のプロパティ)

パフォーマンス & マイグレーション

• references/context-caching.md - テストスイートの高速化
• references/sb4-migration.md - Spring Boot 4.0 の変更点

クイック判断ツリー

コントローラーエンドポイントをテストしている?
  はい → @WebMvcTest with MockMvcTester

リポジトリクエリをテストしている?
  はい → @DataJpaTest with Testcontainers (実際の DB)

サービスのビジネスロジックをテストしている?
  はい → プレーン JUnit + Mockito (Spring コンテキストなし)

外部 API クライアントをテストしている?
  はい → @RestClientTest with MockRestServiceServer

JSON マッピングをテストしている?
  はい → @JsonTest

完全な統合テストが必要?
  はい → @SpringBootTest with minimal context config

Spring Boot 4 のハイライト

• RestTestClient: TestRestTemplate のモダンな代替品
• @MockitoBean: @MockBean を置き換え (非推奨)
• MockMvcTester: Web テスト用の AssertJ スタイルのアサーション
• モジュール化されたスターター: テクノロジー固有のテストスターター
• コンテキストの一時停止: キャッシュされたコンテキストの自動一時停止 (Spring Framework 7)

テストのベストプラクティス

コード複雑性の評価

メソッドまたはクラスがテストするには複雑すぎる場合:

1. 複雑性を分析する - 単一メソッドをカバーするために 5～7 以上のテストケースが必要な場合、コードが複雑すぎる可能性があります
2. リファクタリングを推奨する - コードをより小さく、焦点を絞った関数に分割することを提案します
3. ユーザーの決定 - ユーザーがリファクタリングに同意した場合、抽出ポイントの特定を支援します
4. 必要に応じて続行する - ユーザーが複雑なコードでの継続を決定した場合、困難を伴ってもテストを実装します

リファクタリング推奨の例:

// 前: テストしにくい複雑メソッド
public Order processOrder(OrderRequest request) {
  // バリデーション、割引計算、支払い、在庫、通知...
  // 50+ 行の混在した関心事
}

// 後: テスト可能なユニットにリファクタリング
public Order processOrder(OrderRequest request) {
  validateOrder(request);
  var order = createOrder(request);
  applyDiscount(order);
  processPayment(order);
  updateInventory(order);
  sendNotification(order);
  return order;
}

コードの冗長性を避ける

一般的に使用されるオブジェクトとモック設定のためのヘルパーメソッドを作成して、可読性と保守性を向上させます。

@DisplayName でのテスト組織

テスト意図を明確にするための説明的なディスプレイ名を使用します:

@Test
@DisplayName("Should calculate discount for VIP customer")
void shouldCalculateDiscountForVip() { }

@Test
@DisplayName("Should reject order when customer has insufficient credit")
void shouldRejectOrderForInsufficientCredit() { }

テストカバレッジの順序

常に以下の順序でテストを構成してください:

1. メインシナリオ - ハッピーパス、最も一般的なユースケース
2. その他のパス - 代替的な有効なシナリオ、エッジケース
3. 例外/エラー - 無効な入力、エラー条件、失敗モード

本番環境シナリオのテスト

実際の本番環境シナリオを考慮してテストを記述します。これにより、テストがより関連性を持ち、実際の本番環境でのコード動作を理解するのに役立ちます。

テストカバレッジの目標

品質と効力のバランスを取るため、80% のコードカバレッジを目指してください。より高いカバレッジは有益ですが、唯一の目標ではありません。

カバレッジレポートとトラッキングには Jacoco maven プラグインを使用してください。

カバレッジルール:

• 最小 80% 以上のカバレッジ
• 実行だけではなく、意味のあるアサーションに焦点を当てる

優先事項:

1. ビジネスクリティカルなパス (支払い処理、注文検証)
2. 複雑なアルゴリズム (価格設定、割引計算)
3. エラーハンドリング (例外、エッジケース)
4. 統合ポイント (外部 API、データベース)

依存関係 (Spring Boot 4)

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-test</artifactId>
  <scope>test</scope>
</dependency>

<!-- WebMvc テスト用 -->
<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-webmvc-test</artifactId>
  <scope>test</scope>
</dependency>

<!-- Testcontainers 用 -->
<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-testcontainers</artifactId>
  <scope>test</scope>
</dependency>