For AI agents: the complete documentation index is available at /Practical-Introduction-to-Spring-Boot/llms.txt, the full documentation bundle is available at /Practical-Introduction-to-Spring-Boot/llms-full.txt, and this page is available as Markdown at /Practical-Introduction-to-Spring-Boot/SpringBootテスト入門/開発者テスト入門_テストとは編.md.

開発者テスト入門 - テストとは編

講義の区切り

基本編の目安は 60 分です。終了条件は「同値分割と境界値でケースを選ぶ」です。 発展内容・次回の目安: 状態遷移・Pairwise。基本の確認後に取り組んでください。 準備と前後の章は 学習ガイド で確認できます。

はじめに

本テキストでは、 Spring Boot の詳細設計からテストまでを担当するエンジニアを対象に、開発者テストの基本的な考え方を紹介します。

補足:開発者テスト(Developer Testing)

本テキストが主に扱うのは「開発者テスト」です。これは、開発者が日々の開発の中で実施するテストであり、 単体だけでなく、必要に応じて結合テストや @SpringBootTest を用いた統合寄りの自動テストも含みます。 ISTQB でいうテストレベル(コンポーネント/結合/システム等)とは別の軸(実施者の軸)なので、混同しないように注意してください。

対象読者

  • Spring Boot を触ったことがあり、テストの基本的な考え方を体系的に学びたい人
  • テストの基本について整理したい人
  • テストのアプローチ(ブラックボックス/ホワイトボックス)を理解し、テストに活かしたい人

到達目標

  • Spring Boot のテストレベル(単体/結合/統合/E2E)とアノテーションの対応を理解する
  • テストの目的の代表例(設計を駆動するテスト、回帰を防ぐテスト)を理解する
  • テストの観点(ブラックボックス/ホワイトボックス)を理解し、テストに活かす方法を知る
  • テストの基本的な書き方(Arrange-Act-Assert パターン)を理解する
  • テストの基本的な手法(同値分割、境界値分析など)を理解し、実践できるようになる

次のものはスコープの範囲外とします。

  • テストライブラリの設定や詳しい使い方(AAA を説明する最小限の JUnit のコード例は扱う)
  • 非機能テスト(性能/負荷/セキュリティテストなど)
  • テスト自動化の運用(CI/CD でのテスト実行や、テストの失敗対応など)
  • 外部結合テスト(API 結合、E2E などの実装方法)

読み進め方

まず「テストの狙い」「ブラックボックスとホワイトボックス」「基本的な書き方」を読み、最後にケースを選ぶ技法へ進みます。 以下のアノテーション一覧は全体像をつかむための目安です。初読で暗記する必要はありません。 実装を試したい場合は Spring Boot テスト入門 を参照してください。

テストレベルと Spring Boot アノテーションの目安

  • 単体:Spring 起動なし。ドメイン/サービスのロジック中心
  • 結合:Spring の一部だけ起動(@WebMvcTest, @DataJpaTest, @MybatisTest, @JdbcTest)
  • 統合:@SpringBootTest
  • E2E:起動+HTTP+外部連携も含め、ユーザー視点で通す

非機能テスト(性能/負荷/セキュリティ)は品質の観点による分類で、上記のレベルとは別の軸です。

これらはあくまで目安であり、プロジェクトやチームによっては異なる定義がされることもあります。 アノテーションだけでテストレベルを判断できるとは限りません。実物と接続している範囲を説明することが大切です。 結合と統合をまとめて「統合テスト」と呼ぶ資料もあります。

また、Spring Boot にはテスト用アノテーションが複数用意されており、 単体テストに限らず結合テストや統合テストなど幅広いテストを扱えます。

本テキストで扱うテストの狙い(開発での使われ方の例)

本テキストでは、次のようなテストの狙いを想定して説明します。 これらはあくまで代表例であり、プロジェクトやチームによってはこれ以外の狙い(探索、調査、監視など)もあります。

設計を駆動するテスト(TDD)

  • テスト駆動開発(TDD:Test-Driven Development)で書かれるテスト
  • 先にテストコードを書いてから実装コードを書くスタイル
  • テストコードが設計のドキュメントとしても機能する
  • この順番で検討することで、「コードの使われ方」や「テストのしやすさ」を意識した設計が促される

回帰を防ぐテスト

  • バグ修正や機能追加の際に、既存の機能が壊れていないことを確認するためのテスト
  • 既存のコードに対する変更が、検証した範囲の機能に悪影響を与えていないことを確認する
  • 意図した差分以外で、既存の契約(仕様)が破られていないことを確認する

何に基づいてテストを設計・評価するか(利用する情報)

ブラックボックステスト

ブラックボックステストは、内部構造ではなく仕様(要求・契約)に基づいてテストケースを設計・評価するアプローチです。

  • 仕様(要求)を基準にテストケースを作る
  • どうやるか(How)ではなく、何が起きるか(What)を基準に期待結果を書く
  • 実装変更に強く、リファクタリングで壊れにくい
  • 入力に対し、観測可能な結果(振る舞い)が期待通りになることを確認する

注意点:

  • 実装の分岐を見ないため、網羅漏れ(特に境界・例外)が起きやすい
    → 境界値分析・同値分割・状態遷移などの「テストケース設計技法」と併用する

ホワイトボックステスト

ホワイトボックステストは、内部実装(制御フロー/例外パス/状態遷移/アルゴリズム)を参照して、テストケースの設計やテスト結果の評価をするアプローチです。

  • 条件分岐・例外パス・境界・状態など、内部構造を手掛かりにテストケースを補強する
  • カバレッジ(命令/分岐/条件 など)を「不足の発見」に使い、漏れの有無を評価する
  • (手動の場合)デバッガ等で内部状態を観察して、想定した経路を通っているかを確認することもある

ホワイトボックスは漏れを見つけやすい一方で、内部手順や途中状態を期待結果として固定すると、実装変更(リファクタリング)で壊れやすくなりがちです。
そのため本テキストでは、ホワイトボックスは主に「分析(漏れ確認)」として用い、テストの実装(期待結果の表現)はブラックボックス寄りに保つことを推奨します。

注意点:

  • ホワイトボックスでも「期待結果」は仕様(振る舞い)の言葉で書くと壊れにくい

仕様からケースを作り、実装を見て不足を補う

本テキストでは、テストを 「作る」 と 「漏れを探す」 に分けて考えます。

  • 作成(ブラック):仕様・要求・契約(What)を基準に、入力→観測可能な結果(戻り値/例外/公開状態/外部への書き込み)で期待結果を書く
    → リファクタリングに強く、壊れにくいテストになる

  • 分析(ホワイト):実装を見て、分岐・例外・境界・状態の観点で不足ケースを探す(必要ならカバレッジも“不足発見”に使う)
    → ブラックだけだと抜けやすい例外・境界の漏れを埋められる

運用のコツは 「ホワイトで見つけて、ブラックの形で追加する」 ことです。
つまり、追加するテストの期待結果は「分岐を通すため」ではなく、仕様の言葉(振る舞い)で表現します。

※ private呼び出しや途中変数の値のアサートなど、内部手順の固定はテストを壊れやすくしがちなので、基本は避けます。

テストの基本的な書き方

Arrange-Act-Assert パターン

次の 3 フェーズでテストコードを書くことが推奨されています。

  • 準備(Arrange)
  • 実行(Act)
  • 検証(Assert)

各テストケースは、この 3 フェーズを明確に分け、各フェーズを複数書かないことが原則です。 ※ フェーズがひとつというだけで、例えば、 assert がひとつしかないという意味ではない。

例えば「年齢 0〜120 を受け付ける」という仕様なら、次のように書けます。

フェーズ内容
Arrange(準備)入力値を 120 にする
Act(実行)入力を検証する処理を呼ぶ
Assert(検証)妥当として受け付けられることを確認する

また、同じ考え方は別の呼び名(Given-When-Then など)でも紹介されますが、本テキストでは AAA に用語を統一します。

AAA パターンのコード例

表の例を、Java と JUnit のコードで確認します。 ここでは「整数の年齢が 0〜120 なら true、それ以外なら false を返す」という仕様を考えます。 文字列から数値への変換や null の扱いは、この例の対象外です。

まず、テスト対象を次のように用意します。

src/main/java/dev/mikoto2000/springboot/workshop/util/AgeValidator.java
package dev.mikoto2000.springboot.workshop.util;

public class AgeValidator {
  public static boolean isValid(int age) {
    return 0 <= age && age <= 120;
  }
}

次のテストでは、上限の 120 を受け付ける場合と、上限を超えた 121 を受け付けない場合を確認します。

src/test/java/dev/mikoto2000/springboot/workshop/util/AgeValidatorTest.java
package dev.mikoto2000.springboot.workshop.util;

import static org.junit.jupiter.api.Assertions.assertFalse;
import static org.junit.jupiter.api.Assertions.assertTrue;

import org.junit.jupiter.api.Test;

class AgeValidatorTest {
  @Test
  void 年齢120は受け付ける() {
    // Arrange(準備): テスト対象に渡す入力を用意する
    int age = 120;

    // Act(実行): テスト対象の処理を呼び出す
    boolean actual = AgeValidator.isValid(age);

    // Assert(検証): 結果が仕様どおりであることを確認する
    assertTrue(actual);
  }

  @Test
  void 年齢121は受け付けない() {
    // Arrange(準備)
    int age = 121;

    // Act(実行)
    boolean actual = AgeValidator.isValid(age);

    // Assert(検証)
    assertFalse(actual);
  }
}

@Test は JUnit にテストメソッドであることを伝えます。 assertTrue は結果が true、assertFalse は結果が false であることを検証し、異なればテストを失敗させます。 期待結果は仕様から決め、テスト内で 0 <= age && age <= 120 を再計算しないことがポイントです。

この例は Spring の機能を使わない単体テストなので、@SpringBootTest は不要です。 実行する場合は、Spring Boot テスト入門 の「事前準備と到達目標」で用意したプロジェクトに、上記の 2 ファイルを配置してください。 プロジェクトのルートで ./mvnw -Dtest=AgeValidatorTest test を実行すると、この 2 件のテストを確認できます。 Windows PowerShell では .\mvnw.cmd -Dtest=AgeValidatorTest test、コマンドプロンプトでは mvnw.cmd -Dtest=AgeValidatorTest test を使います。

AAA は「選んだケースをどう書くか」の型です。この 2 件だけで、年齢の仕様を十分に確認できるわけではありません。 次の「テストケース設計の技法」で、代表値や下限側の境界など、追加するケースを考えます。

テストコードの判断を単純に保つ

期待値をテスト対象と同じ計算で求めると、同じ間違いを見逃します。期待値は仕様から具体的に決めましょう。 ケースごとの if やループが増える場合は、入力と期待値を列挙するパラメタライズドテストを検討します。 準備用の共通処理まで一律に禁止するという意味ではありません。

テストで確認することはひとつの振る舞いだけ
  • ひとつのテストケースで確認するのはひとつの振る舞いだけ
  • 振る舞い: Arrange の条件で Act したときに、観測可能な結果(戻り値/状態/例外/外部への書き込み)が期待通りになること
  • 1テスト1振る舞い: 失敗原因を1つに絞れる粒度で書くこと(assert を1個にせよ、ではない)

テストケース設計の技法

テストケース設計では、「どんな入力・状態・組み合わせをテストすべきか」を体系的に洗い出します。 闇雲にケースを増やすのではなく、漏れを減らしつつ、必要十分な数に絞るのが目的です。

本テキストでは、次の代表的なテストケース設計技法を紹介します。

同値分割

入力を「同じ結果になりそうなグループ(同値分割)」に分け、各グループから代表値を選んでテストする手法です。

  • 目的:ケース数を抑えつつ、仕様の網羅漏れを減らす
  • 手順:
    1. 入力条件(値の範囲、形式、必須/任意など)を列挙する
    2. 条件ごとに「妥当なクラス」「不正なクラス」に分割する
    3. 各クラスから代表値を選ぶ(通常は1つずつ)

例(年齢の入力:0~120が妥当):

次のように「妥当」と「不正」をそれぞれ同値なグループとして扱い、それぞれのグループから代表値を選びます。

  • 妥当:0~120 のグループから、例えば 30 を選ぶ
  • 不正:-1以下 / 121以上 / 数値でない / null(必須なら)

年齢の同値分割:-1以下、0~120、121以上の3グループから、代表値として-1、30、121を選ぶ。数値でない入力とnullは別途確認する。

数値でない入力のテストは、文字列を数値に変換する入口が対象です。整数を受け取るメソッドには直接渡せません。null も同じで、Integer やリクエスト DTO など参照型の入口で確認します。この例の int 引数には渡せません。 0、1、119、120 などの境界付近は、次の境界値分析で追加します。

同値分割するときは「妥当」「不正」をセットで考えると漏れにくくなります。

境界値分析

バグが入りやすい「境界(端)」に着目してテストする手法です。 同値分割の補強として使われます。

  • 目的:境界付近の off-by-one(1つズレ)や比較演算ミスを早期に検出する
  • 典型パターン:
    • 最小値
    • 最小値プラスマイナス 1
    • 最大値
    • 最大値プラスマイナス 1
    • 0, 1, -1(符号やゼロを扱う場合)
    • 空, 1件, 最大件数(コレクション・文字列長・ページング)

例(0~120が妥当):

次のように、典型パターンに沿って、境界値を中心にテストケースを選びます。

  • -1(最小-1)
  • 0(最小)
  • 1(最小+1)
  • 119(最大-1)
  • 120(最大)
  • 121(最大+1)

年齢の境界値分析:-1と121は不正、0、1、119、120は妥当。下限と上限それぞれの前後を確認する。

境界値は「仕様に書かれた境界」だけでなく、「実装上の境界(桁数、丸め、型変換)」も意識すると効果的です。

確認:ケースを選んでみる

終了条件「同値分割と境界値でケースを選ぶ」の確認として、次の仕様でケースを自分で選んでみましょう。

  • パスワードは 8〜100 文字(それ以外は不正)

解答例:

  • 同値分割: 妥当な 8〜100 から 20、不正な 7 以下から 7、101 以上から 101
  • 境界値: 7(最小-1)、8(最小)、9(最小+1)、99(最大-1)、100(最大)、101(最大+1)
  • 文字列長の仕様なので、空文字と null は「必須」のケースとして別に確認する

その他テストケース設計(発展)

  • 状態遷移テスト:状態マシンの状態と遷移を網羅する
    • 役立つとき: 状態依存の振る舞いが多い場合
      • ステータスを持つドメインが中心(申請→承認→却下、注文→支払い→出荷など)
      • 「ある状態ではできる/できない」が要件に多い
      • 事故が「不正遷移」「遷移漏れ」で起きがち
  • ペアワイズテスト:任意の2因子間の値の組み合わせを網羅する(全組み合わせは保証しない)
    • 役立つとき: パラメータの組み合わせが多い場合
      • 条件/フラグ/設定が多い(例:権限×プラン×機能フラグ×言語…)
      • クエリ条件が多い検索API(filter/sort/optionが増殖)
      • 環境差(DB種別、OS、ブラウザ)×機能が多い

まずは同値+境界で設計し、状態依存や組み合わせ爆発が出たら追加で検討してください。

Pairwise の保証範囲

Pairwise は、任意の2因子を選んだとき、その値の組み合わせをすべて含める手法です。 全因子の組み合わせをすべて実行する保証はありません。 次の3因子が各2値の場合、4ケースで全ペアを含められますが、全組み合わせは8ケースです。

ケースブラウザーOS言語
1AX日本語
2AY英語
3BX英語
4BY日本語

たとえば A・X・英語の3因子同時の不具合は、この表では検知できません。 3因子以上の相互作用が重要な条件や、業務上の重要ケースは別に追加します。 実行不能な組み合わせがある場合は、その制約を含めてケースを作成してください。

まとめ

本テキストでは、次のポイントを押さえてテストの基本と少々の Spring Boot との関連を紹介しました。

  • Spring Boot のテストは、単体に限らず結合/統合/E2E まで幅広いレベルで考える。
  • 「単体/結合」などの用語はチームで定義し、何を実物と接続しているかを明確にする。
  • テストはブラックボックス(仕様の振る舞い)で書き、ホワイトボックス(分岐・例外・境界・状態)は漏れ確認に使う。
  • テストケース設計は、まず同値分割と境界値を押さえる(状態遷移・ペアワイズは必要になったら)。

テストは「安心して変更できる状態」を作るための技術です。まずは小さく、でも確実に積み上げていきましょう。

参考資料