単体・結合・総合・受入テストの違い — 工程ごとの根拠と境界値

単体・結合・総合・受入テスト。4枚のテスト用チェックカードと、組み合わせた部品を調べる虫眼鏡。

「テストを書いた」と言うとき、たいてい単体テストのことだけを指しています。 このサイトでも、Vitest の回も node –test の回も、部品ひとつを確かめる話でした。

ところが実務で「テスト工程」と言われたら、単体・結合・総合・受入の4つがあり、それぞれ「誰が」「何を根拠に」「何を合格とするか」が違います。 ここを分けずにいると、「全部テストしました」と言ったのに本番で落ちる、という一番まずい形になります。

この記事は、前回書いた要件定義書と設計書を根拠にして、4つのテストを実際に1本ずつ作る回です。

対象レベル: 中級 / 区分: 必修

目次

この記事でわかること

  • 4つのテストが「何を根拠にするか」で分かれていること
  • テストケースの書き方——手順ではなく、条件と期待結果を書く
  • 境界値と同値分割で、ケースを減らしながら漏れを減らすやり方
  • デグレを、わざと起こして検出できるようにすること
  • エビデンスが何のために要るのか(そして、何なら省けるのか)

この記事でやること

  1. 4つのテストを、V字の左と対応づける
  2. 境界値でテストケースを作る(山場①)
  3. 単体・結合・総合・受入を1本ずつ、実際に走らせる
  4. わざとデグレを起こして、どのテストが気づくか見る(山場②)
  5. 合否の記録を、自動で残す形にする

先に知る言葉

この記事で初めて出てくる言葉です。 詳しくは用語集にもまとめてあります。

言葉意味
テストケース「この条件のとき、こうなる」を1つ書いたもの。手順書ではない
同値分割同じ結果になる入力をひとまとめにして、代表を1つだけ試す
境界値その塊の境目。バグはここに集まる
デグレ直したつもりが、動いていた別の場所を壊すこと
エビデンス「確かに合格した」と後から示せる記録

① 4つのテストは「根拠」で分かれている

テスト根拠にする文書確かめること落ちたとき直す場所
単体詳細設計部品1つが、決めたとおりに動くその部品
結合基本設計部品どうしが繋がる(API・DB・画面)繋ぎ方・インタフェース
総合基本設計+非機能要件システム全体が、条件下で成立する構成・設定・性能
受入要件定義使う人が、目的を達せられる要件の解釈

「単体テストが全部通ったから品質は大丈夫」が成り立たない理由が、この表にあります。 単体テストが根拠にしているのは詳細設計だけです。設計そのものが要件とずれていたら、単体テストは全部通ります。

② 境界値でケースを作る

前回の要件から1つ選びます。

FR-01 利用者は、ひとことを投稿できる
      (本文は 1 文字以上 140 文字以内)

全部の文字数を試すことはできません。 そこで、結果が同じになる範囲でまとめます(同値分割)。

  0文字      1〜140文字        141文字〜
 ┌────────┬──────────────────┬──────────┐
 │  エラー  │      成功        │  エラー   │
 └────────┴──────────────────┴──────────┘
      ↑    ↑                ↑    ↑
      0    1               140   141   ← ここだけ試す(境界値)

3つの塊があるので、代表3つ+境目4つ。 実際に書くのは、重複を除いた5ケースです。

cat > docs/testcases.md <<'EOF'
# テストケース(FR-01 投稿)

| ID | 区分 | 条件 | 期待結果 |
|----|------|------|----------|
| TC-001 | 単体 | 本文 0 文字 | 400 / メッセージ「本文を入力してください」 |
| TC-002 | 単体 | 本文 1 文字 | 201 / 保存される |
| TC-003 | 単体 | 本文 140 文字 | 201 / 保存される |
| TC-004 | 単体 | 本文 141 文字 | 400 / メッセージ「140文字以内で入力してください」 |
| TC-005 | 単体 | 本文が空白のみ(全角空白 3 文字) | 400(空白だけは 0 文字と同じ扱い) |
EOF

TC-005 が、この5つの中で一番よくバグります。 「1文字以上」を length > 0 で実装すると、全角空白だけの投稿が通ります。境界は文字数だけではなく、「何を1文字と数えるか」にもあります。 文字コードの回で見た「文字数が数えられない」問題が、そのままここに出ます。

テストケースは手順書ではない

✗ 1. ブラウザを開く 2. ログインする 3. 投稿欄に入力する 4. ボタンを押す
✓ 条件: 本文 141 文字 / 期待結果: 400 と「140文字以内で入力してください」

手順を書くと、画面が変わるたびに全ケースが腐ります。 条件と期待結果だけにしておけば、実行方法(画面から・curl から・自動テストから)が変わっても、ケースは生き残ります。

③ 単体テスト —— 部品1つを、詳細設計どおりに

cd ~/hitokoto
cat > test/validate.test.js <<'EOF'
import { test } from "node:test";
import assert from "node:assert/strict";
import { validateBody } from "../src/validate.js";

// TC-001〜TC-005(docs/testcases.md)
const cases = [
  ["TC-001", "",                 false],
  ["TC-002", "a",                true ],
  ["TC-003", "あ".repeat(140),   true ],
  ["TC-004", "あ".repeat(141),   false],
  ["TC-005", "   ",            false],
];
for (const [id, body, ok] of cases) {
  test(`${id}: ${JSON.stringify(body).slice(0, 12)}`, () => {
    assert.equal(validateBody(body).ok, ok);
  });
}
EOF
node --test test/
✔ TC-001: ""
✔ TC-002: "a"
✔ TC-003: "ああああああ…
✖ TC-005: "   "
  ...
# fail 1

TC-005 が落ちました。 予想どおりです。trim() を足して直します。テストケースをテスト名に書いておくと、落ちたときにどの条件かがすぐ分かります。

④ 結合テスト —— 部品どうしが繋がるか

単体テストは validateBody しか見ていません。API から DB まで通したときに繋がるかは、別の話です。

cat > test/api.test.js <<'EOF'
import { test, before, after } from "node:test";
import assert from "node:assert/strict";
import { startServer } from "../src/server.js";

let base;
before(async () => { base = await startServer({ port: 0 }); });
after(async () => { await base.close(); });

test("IT-001: POST /api/posts → GET /api/posts に出てくる", async () => {
  const r1 = await fetch(`${base.url}/api/posts`, {
    method: "POST",
    headers: { "Content-Type": "application/json", Cookie: base.testCookie },
    body: JSON.stringify({ body: "結合テストの投稿" }),
  });
  assert.equal(r1.status, 201);

  const r2 = await fetch(`${base.url}/api/posts`);
  const list = await r2.json();
  assert.ok(list.some((p) => p.body === "結合テストの投稿"));
});

test("IT-002: 未ログインでは投稿できない(FR-04)", async () => {
  const r = await fetch(`${base.url}/api/posts`, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ body: "だめなはず" }),
  });
  assert.equal(r.status, 401);
});
EOF
node --test test/

結合テストで初めて見つかるのは、たいてい次の3つです。

よく出る食い違い単体では見つからない理由
項目名の綴り(body と text)片方ずつは正しく動く
日付の形式(ISO 8601 とローカル表記)それぞれの中では一貫している
NULL の扱い(空文字か NULL か)DB とアプリで解釈が違う

⑤ 総合テスト —— 非機能を確かめる

ここが飛ばされやすい工程です。 機能は全部動いているので、やらなくても「完成」に見えます。前回書いた非機能要件を根拠に測ります。

# NFR-01: 1万件で一覧が 1 秒以内
node scripts/seed.js 10000
curl -s -o /dev/null -w "%{time_total}\n" http://localhost:3000/api/posts
2.418

落ちました。 索引が効いていません。詳細設計に「posts(created_at DESC) の索引を張る(NFR-01 のため)」と書いてあったのに、実装で入れ忘れています。

mysql -u app -p appdb -e "CREATE INDEX idx_posts_created ON posts(created_at DESC);"
curl -s -o /dev/null -w "%{time_total}\n" http://localhost:3000/api/posts
0.061

これは単体テストでも結合テストでも絶対に見つかりません。 どちらもデータが数件しか無いからです。非機能は、その条件を作らないと落ちない——だから工程として分かれています。

可用性の要件(NFR-02・NFR-03)も、ここで確かめます。

# バックアップから復元できるか(RTO/RPO の確認)
mysqldump -u root -p appdb > /tmp/backup.sql
mysql -u root -p -e "DROP DATABASE appdb; CREATE DATABASE appdb;"
time mysql -u root -p appdb < /tmp/backup.sql
curl -s http://localhost:3000/api/posts | head -c 80

「バックアップを取っている」ではなく「戻せた」まで確かめます。 デプロイの回でも同じことを書きましたが、復元を1回もやっていないバックアップは、無いのと同じです。

⑥ 受入テスト —— 要件定義を根拠に

受入テストだけは、作った人ではなく使う人が、要件の言葉で確かめます。 実装の言葉を1つも使わないのが目印です。

| ID | 要件 | 確かめること | 結果 |
|----|------|--------------|------|
| UAT-01 | FR-01 | ひとことを投稿すると、一覧の先頭に出る | ✅ |
| UAT-02 | FR-03 | 他人の投稿には削除ボタンが出ない | ✅ |
| UAT-03 | FR-04 | ログアウト状態では投稿欄が出ない | ✅ |
| UAT-04 | NFR-02 | 壊してから、手順書だけで 24 時間以内に戻せる | ✅ |

UAT-04 のように「手順書だけで」と条件を付けると、属人性が測れます。 書いた本人が記憶で復旧できても、それは合格ではありません。

⑦ わざとデグレを起こす

テストが本当に役に立つかは、「壊したときに落ちるか」でしか分かりません。 一度わざと壊します。

# 一覧の並びを、うっかり昇順に変えてしまう(よくある事故)
sed -i 's/ORDER BY p.created_at DESC/ORDER BY p.created_at ASC/' src/posts.js
node --test test/
# pass 7
# fail 0

全部通ってしまいました。 FR-02「新しい順に見られる」を確かめるケースが1つも無いからです。要件はあるのにテストが無い——前回の check_trace.sh が探していたのは、まさにこれです。

cat >> test/api.test.js <<'EOF'

test("IT-003: 一覧は新しい順(FR-02)", async () => {
  const list = await (await fetch(`${base.url}/api/posts`)).json();
  const times = list.map((p) => new Date(p.created_at).getTime());
  assert.deepEqual(times, [...times].sort((a, b) => b - a));
});
EOF
node --test test/    # 今度は落ちる
sed -i 's/ORDER BY p.created_at ASC/ORDER BY p.created_at DESC/' src/posts.js
node --test test/    # 直すと通る

「直したら通った」だけでは足りません。 「壊したら落ちた」を先に見る——このサイトで検査を足すときに毎回やっていることを、テスト工程でもそのままやります。落ちないテストは、あっても無くても同じです。

⑧ 記録(エビデンス)を、自動で残す

エビデンスは「あとから、やったと示すため」に要ります。 画面のスクリーンショットを全ケースぶん撮るのは現実的ではないので、機械が出す記録を残します。

mkdir -p docs/evidence
node --test --test-reporter=tap test/ > "docs/evidence/$(date +%Y%m%d_%H%M)_unit.tap" 2>&1
curl -s -o /dev/null -w "%{time_total}\n" http://localhost:3000/api/posts \
  > "docs/evidence/$(date +%Y%m%d_%H%M)_nfr01.txt"
ls docs/evidence/
残す残さない
実行日時・実行したコマンド・出力手順どおりに操作した画面の連続写真
失敗した記録(直した経緯とセット)成功だけを選んで並べたもの
環境(版・件数・設定)——

失敗の記録を消さないでください。 「一度落ちて、直して、通った」という履歴のほうが、最初から緑の記録より価値があります。

完成の判定

#確かめること合格の形
1境界値のケースがある0 / 1 / 140 / 141 / 空白のみ
2結合で繋がりを見ているPOST したものが GET に出る
3非機能を測っている1万件で 1 秒以内という数字が出ている
4受入が要件の言葉で書けている実装用語が 1 つも出てこない
5壊したら落ちる並び順を変えると IT-003 が失敗する

つまずいたところ

単体テストが全部通るのに、本番で落ちる

単体テストの根拠は詳細設計だけです。 設計自体が要件とずれていたら、全部通ります。上の工程のテストを飛ばしていないか、V字の対応表で確かめてください。

結合テストが不安定になる

テストどうしがデータを共有しています。各テストの前に、そのテストが使うデータを作るのが確実です。Docker で CI を回した回と同じで、使い捨てにできる状態を作るのが根本の解です。

ケースが増えすぎて、実行に時間がかかる

同値分割ができていません。同じ結果になる入力をまとめて、境目だけ試します。 1〜140 文字を全部試す必要はありません。

受入テストで、いまさら仕様の食い違いが出る

これは工程の問題ではなく、要件定義の問題です。 受入テストで見つかるのは仕様の解釈違いで、テストが遅かったのではなく、要件が曖昧だったということです。次の案件では、要件に「確かめ方」を書く欄を足してください。

後片づけ

cd ~/hitokoto
node scripts/seed.js --clean      # 1万件の投入データを消す
mysql -u app -p appdb -e "SELECT COUNT(*) FROM posts;"

よくある質問

単体テストと結合テストの境界がよく分かりません
外部に触れるかどうかで切るのが実務的です。関数を呼んで戻り値を見るだけなら単体、データベースやネットワークやファイルに触れるなら結合と考えると、判断がぶれません。呼び出す相手を偽物に差し替えているかどうか、と言い換えても構いません。厳密な定義は現場ごとに違うので、チームの中で一貫していることのほうが大事です。
総合テストは個人開発でも必要ですか
必要です。ただし規模は小さくて構いません。データを本番想定の件数まで増やして応答時間を測ること、バックアップから実際に復元してみることの2つだけでも、単体テストでは絶対に見つからない問題が見つかります。個人開発で一番よく起きるのは、データが増えた瞬間に遅くなる問題と、バックアップが復元できない問題です。
エビデンスはどこまで残せばよいですか
実行したコマンドと、その出力と、実行日時と環境が残っていれば足ります。画面の写真は、機械の出力では示せないもの(表示崩れや操作性)に限ってください。全ケースの画面を撮る運用は作業量が大きいわりに、あとから読み返されることがほとんどありません。何のために残すかを決めてから、必要な形式を選んでください。
テストケースは実装前と実装後、どちらで書きますか
実装前です。実装を見てから書くと、実装がそうなっているという理由でケースを作ってしまい、設計とのずれを見つけられなくなります。テスト駆動開発が先に失敗するテストを書くのと同じ理屈で、根拠にする文書を見ながら書けば、実装を見なくてもケースは作れます。
デグレを防ぐには、どのテストを増やすべきですか
結合テストを増やすのが費用対効果として高くなります。デグレの多くは部品の中ではなく、部品どうしの前提のずれで起きるからです。ただし増やす前に、この記事でやったように一度わざと壊して、いまあるテストが気づくかを確かめてください。落ちないテストをいくら増やしても、デグレは止まりません。

まとめ — 理解できたこと

  • 4つのテストは「根拠にする文書」で分かれている。 粒度でも規模でもない
  • 単体テストが全部通っても、設計が要件とずれていれば意味がない
  • テストケースは手順ではなく、条件と期待結果。 手順を書くと画面が変わるたびに腐る
  • 境界値にバグが集まる。 0 / 1 / 上限 / 上限+1 / 空白だけ
  • 非機能は条件を作らないと落ちない。 だから工程として分かれている
  • 「壊したら落ちる」を先に見る。 落ちないテストは、あっても無くても同じ

参考リンク

次に読む

この記事は 【第8段階】深掘り の 23 / 30 本目です。

記事
← 前の記事要件定義と基本設計・詳細設計 — V字モデルの対応表
→ 次の記事運用設計で決める6項目 — 手順書に判定基準を書く

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次