ペアワイズテストとは？テストケースを大幅削減する手法＋allpairspy×pytest実装

ペアワイズテストとは、複数のパラメータの組み合わせを「任意の2つのパラメータが最低1回ずつテストされる」ことで保証しながら、テストケース数を大幅に削減するテスト設計技法です。OS・ブラウザ・設定項目の組み合わせ爆発を効率よく解消できます。

ペアワイズテストを使うと「全パターンをテストしなければ」というプレッシャーから解放され、少ないテストケースで高いバグ検出率を実現できます。研究によると、ほとんどのバグは2つのパラメータの相互作用から発生するからです。

「OS3種類 × ブラウザ4種類 × 言語設定2種類 = 24パターン」——設定項目が増えるたびにテスト数が指数的に膨らんでいませんか？

• 条件が増えるたびに全組み合わせが爆発的に増えてテストが追いつかない
• 全パターンを実行する時間もリソースもない
• かといってテストを削りすぎると見落としが心配

ペアワイズテストはこうした問題を解決する技法です。この記事では概念から具体的なテストケース生成・pytestへの応用まで一気通貫で解説します。

ペアワイズテストとは？

ペアワイズテスト（Pairwise Testing）とは、「複数のパラメータの中から任意の2つのペアが必ず1回以上テストされる」最小限のテストケースセットを生成するテスト設計技法です。「2因子間網羅」「オールペア法」とも呼ばれます。

なぜ「2つのペア」で十分なのかというと、研究によってほとんどのバグは1〜2つのパラメータの組み合わせによって引き起こされることが示されているためです。3つ以上のパラメータが同時に特定の値になって初めて発生するバグは非常にまれです。

ペアワイズテストの仕組みとは？

ペアワイズテストがどうテストケースを削減するか、具体例で確認します。

例：Webアプリのクロス環境テスト

次の3つのパラメータを持つシステムをテストする場合を考えます。

ペアワイズ法で生成された9パターン

この9パターンで「OS×ブラウザ」「OS×言語設定」「ブラウザ×言語設定」のすべての組み合わせが最低1回カバーされます。27パターンから67%削減しながら、2パラメータ間の網羅性は完全に保たれています。

デシジョンテーブルとの違いとは？

同じ「組み合わせテスト」系の技法でも、デシジョンテーブルとペアワイズテストは使い分けるべき場面が明確に異なります。

allpairspyを使ったテストケース自動生成

ペアワイズテストのケースを手動で設計するのは難しいため、実務では allpairspy（Python）などのツールで自動生成します。

インストール

pip install allpairspy

テストケースの自動生成

from allpairspy import AllPairs

# パラメータを定義
parameters = [
    ["Windows", "macOS", "Linux"],          # OS
    ["Chrome", "Firefox", "Safari"],         # ブラウザ
    ["日本語", "英語", "韓国語"],            # 言語設定
]

# ペアワイズテストケースを自動生成
test_cases = [case.test_parameters for case in AllPairs(parameters)]

for i, case in enumerate(test_cases, 1):
    print(f"ケース{i}: OS={case[0]}, ブラウザ={case[1]}, 言語={case[2]}")

実行結果（出力例）

ケース1: OS=Windows, ブラウザ=Chrome, 言語=日本語
ケース2: OS=Windows, ブラウザ=Firefox, 言語=英語
ケース3: OS=Windows, ブラウザ=Safari, 言語=韓国語
ケース4: OS=macOS, ブラウザ=Chrome, 言語=英語
ケース5: OS=macOS, ブラウザ=Firefox, 言語=韓国語
ケース6: OS=macOS, ブラウザ=Safari, 言語=日本語
ケース7: OS=Linux, ブラウザ=Chrome, 言語=韓国語
ケース8: OS=Linux, ブラウザ=Firefox, 言語=日本語
ケース9: OS=Linux, ブラウザ=Safari, 言語=英語
# 27パターン → 9パターンに削減！

pytestのparametrizeとの組み合わせ

生成したテストケースをそのままpytestの @pytest.mark.parametrize に渡すことで、自動テストに即変換できます。

import pytest
from allpairspy import AllPairs

# パラメータを定義
parameters = [
    ["Windows", "macOS", "Linux"],
    ["Chrome", "Firefox", "Safari"],
    ["日本語", "英語", "韓国語"],
]

# allpairspyでテストケースを生成
pairwise_cases = [case.test_parameters for case in AllPairs(parameters)]

# そのままparametrizeに渡す
@pytest.mark.parametrize("os, browser, language", pairwise_cases)
def test_web_app_cross_env(os, browser, language):
    """ペアワイズテスト：クロス環境でWebアプリが正常動作するか確認"""
    print(f"テスト環境: {os} / {browser} / {language}")
    # ここに実際のテストロジックを記述
    # 例：Playwrightでブラウザを起動して検証など
    assert True  # 実装時はここに検証コードを追加

実行結果サンプル

$ pytest test_pairwise.py -v

collected 9 items

test_pairwise.py::test_web_app_cross_env[Windows-Chrome-日本語]  PASSED
test_pairwise.py::test_web_app_cross_env[Windows-Firefox-英語]   PASSED
test_pairwise.py::test_web_app_cross_env[Windows-Safari-韓国語]  PASSED
test_pairwise.py::test_web_app_cross_env[macOS-Chrome-英語]      PASSED
test_pairwise.py::test_web_app_cross_env[macOS-Firefox-韓国語]   PASSED
test_pairwise.py::test_web_app_cross_env[macOS-Safari-日本語]    PASSED
test_pairwise.py::test_web_app_cross_env[Linux-Chrome-韓国語]    PASSED
test_pairwise.py::test_web_app_cross_env[Linux-Firefox-日本語]   PASSED
test_pairwise.py::test_web_app_cross_env[Linux-Safari-英語]      PASSED

========================== 9 passed in 0.08s ===========================

ペアワイズテストが特に有効な場面

ペアワイズテストが実務で特に効果を発揮する場面を整理します。

⚠️ ペアワイズテストでよくある失敗パターン4選

実務でペアワイズテストを適用するときに陥りやすい失敗を紹介します。

FAQ

📋 この記事のまとめ

ペアワイズテストは「全部テストしたいけど時間がない」というジレンマを解決する現実的な技法です。まずは allpairspy をインストールして、手元の設定項目やクロス環境テストに適用してみましょう。27パターンが9パターンになる瞬間、テスト設計の見方が変わります。