ブラックボックス・グレーボックス・ホワイトボックステスト

ブラックボックステストは入力と出力だけを見て、コードの書き方には関心を持ちません。ホワイトボックステストはコードと分岐を読みます。グレーボックステストはその中間で、テストする人は内部情報の一部(API、ログ、データ構造、計測イベント)を知っていますが、実装を行単位で読むことはしません。 3 つは同じ機能をテストします。違うのは、内部情報をどれだけ持っているか、そしてその結果としてどんな問いを立てられるかです。 選び間違えると具体的なコストが出ます。グレーボックスでしか見えない問題(フィールドの型が変わった、など)をブラックボックスで探しても、100 回試して見つかりません。逆に、業務テスターにコードを読むよう求めるのは、テストを開発の片手間仕事にしてしまいます。

3 つのボックスの比較

観点 ブラックボックス グレーボックス ホワイトボックス
内部知識 ほぼなし。要件と画面だけ API、ログ、データ構造、実装の一部 コードと構造の全体
何を検証するか 振る舞いが期待どおりか 振る舞い+内部の整合性 分岐、境界、網羅性
誰がやるか 業務テスター、プロダクト、カスタマーサクセス API を知るテスター、開発 開発
代表的な手法 同値分割、境界値、決定表、状態遷移、ペアワイズ API 検証、ログ照合、計測の検証、契約テスト 単体テスト、カバレッジ、静的解析
コスト 最小。すぐ始められる 中。環境とドキュメントが必要 最大。コードを読む必要がある
見落とすもの 特定のデータや環境でだけ出る問題 システム間のタイミング問題 利用者が気づかない問題
見落とされがちな事実があります。Web チームが日常的にやっていることの大半はグレーボックスで、そう呼んでいないだけです。ネットワークパネルでステータスコードを見る、コンソールでエラーを見る。これはすでに内部情報を使っています。

ブラックボックスの 5 手法

ログインフォームを例にします。
  • 同値分割:入力を「有効な電話番号/不正な形式/空」に分け、それぞれ 1 つ代表値を試す。
  • 境界値:パスワードが 8〜20 文字なら、7・8・20・21 を試す。
  • 決定表:「アカウントあり × パスワード正しい × ロック中」を組み合わせ、各行を検証する。
  • 状態遷移:未確認 → 確認済み → ロック。各経路と不正な遷移を確認する。
  • ペアワイズ:ブラウザ × OS × 言語 × ロールを 2 つずつ組み合わせ、最小のケースで最大の組み合わせを覆う。
  • どれも内部情報を必要としませんが、組み合わせると「適当に触る」が再利用できるケース集になります。ケースの書き方はテストケースのテンプレートと例にあります。

    Web チームでのグレーボックスの実践

    コードを読む必要はありません。開発者ツールで足ります。
    • リクエストを見る:ネットワークで、API が 200 でもフィールドが変わっている、あるいは 4xx / 5xx を返していることを確認する。
    • エラーを見る:コンソールの赤い表示は、画面上の症状より原因に近いことが多い。
    • 契約を見る:API ドキュメントが price: number なのに、応答が "12.00"。これはグレーボックスでしか見つからない。
    • 計測を見る:送信されていないイベントは画面では見えませんが、意思決定を歪めます。
    4 つの共通点は、どれも「利用者に見える症状」ではないのに、そのバグを直すかどうか、誰が直すかを決めることです。

    ブラックボックスの報告が差し戻される理由

    証拠が足りないからです。同じ事象を 2 通りで書きます。
    書き方 開発が次にすること
    「ログインを押しても何も起きない」 どのアカウント、どのブラウザ、コンソールに赤い表示はあるかを聞く
    「Chrome 141 / Windows 11。テストアカウント A が https://example.com/login で正しいパスワードを入力してログインを押すが遷移しない。ネットワークで POST /api/login が 500、コンソールに Unhandled promise rejection」 そのままサーバーログを見に行く
    差は文章力ではなく、グレーボックスの 3 情報(環境、失敗したリクエスト、エラー原文)が付いているかです。 ここに現実の矛盾があります。ブラックボックスのテスター(業務、サポート、顧客)は、本来コンソールを見る必要はありません。解決策は教育ではなく、取得の自動化です。ブラウザ拡張を入れる、あるいはサイトにフィードバック入口を埋め込み、コンソールエラー、失敗リクエスト、ブラウザとビューポートを一緒に持たせます。BugCapturer が担うのはこの層です。テストする人はブラックボックスのまま、レポートにはグレーボックスの情報が付きます。

    ブラックボックスで足りるとき、グレーが必須のとき

    場面 推奨 理由
    新機能が要件どおりかの受け入れ ブラックボックス 見るのは振る舞いで、実装ではない
    リリース前の回帰確認 ブラックボックス+主要経路はグレー 流れは振る舞い、ログインと決済はリクエスト
    API フィールド変更、結合確認 グレーボックス 画面は正常に見えてもデータがすでに違う
    性能とタイムアウト グレーボックス リクエストの所要時間と失敗率が必要
    セキュリティと権限 主にグレーボックス 権限昇格は画面上ほぼ見えない
    静的ページ、文言変更 ブラックボックス 内部の連鎖がない
    ホワイトボックスが表にないのは、テスターの仕事であることが少ないからです。単体テスト、カバレッジ、静的解析は開発の自己確認に属し、受け入れテストとは別の流れです。

    例:決済コールバックを 3 つの視点で見る

    同じ症状でも、答えの深さが 3 段階になります。
    • ブラックボックス:顧客は決済を完了したのに、注文は「支払い待ち」のまま。振る舞いが期待と違うので起票する。
    • グレーボックス:ネットワークで POST /api/pay/callback は 200 だが、本文の status が pending。コンソールは静か。問題はサーバー側の状態処理で、フロントではない。
    • ホワイトボックス:コールバック処理はログを書いてから注文を更新し、更新失敗を空の catch が飲み込んでいる。論理的な欠陥で、同種の問題が他にもある可能性が高い。
    実務的な結論はこうです。2 段目まで届いた報告なら、開発はすぐ着手できます。1 段目のままなら 3 往復かかります。 2 段目に届くのにコードを読む必要はなく、そのリクエストを添えるだけです。

    ボックスをテスト計画に書き込む

    段階 主なボックス 成果物
    要件レビュー後 ブラックボックス ケース設計と受け入れ基準
    結合・初回ビルド グレーボックス 契約確認、フィールドとエラーコードの一覧
    リリース前の回帰 ブラックボックス+主要経路はグレー 回帰チェックリスト、主要経路のリクエスト記録
    リリース後 グレー(ログと監視)+ブラック(実際の声) アラート規則、利用者からの報告
    責任分界が要点です。ブラックボックスは「正しいか」、グレーは「なぜ違うか」、ホワイトは「コード自体に危険がないか」を担当します。

    グレーボックスの 3 つの前提

    グレーボックスは宣言して始められるものではありません。どれか 1 つ欠けるとブラックボックスに戻ります。
  • 環境に入れる:テスト環境に到達でき、アカウントに権限がある。なければリクエストすら送れません。
  • ログとリクエストが見える:最低でも開発者ツール、できればサーバーログ。
  • 契約を知っている:フィールド、エラーコード、必須項目が文書化されているか、聞ける人がいる。
  • 最も欠けやすいのは 3 番目です。契約がないと「画面が正しいか」は判断できても「データが正しいか」は判断できず、フィールド単位の問題が本番まで抜けます。

    よくある 3 つの誤解

    • ホワイトボックス=単体テスト:最も典型的な用途ですが、コードレビュー、カバレッジ分析、静的スキャンも含みます。
    • グレーボックス=コードを読む:中心は内部情報を知ること。ログやリクエストを見るのは該当し、実装を読む必要はありません。
    • 自動化=ホワイトボックス:UI 自動化は通常ブラックボックス(画面を操作するだけ)で、API 自動化はグレーに近いです。手法とボックスは別の軸です。

    よくある質問

    ブラックボックステストに技術知識は必要ですか? コードの知識は不要ですが、症状を正確に描写し、データを用意し、期待どおりの挙動かを判断する必要があります。残りの証拠はツールに任せられます。 グレーボックスに API ドキュメントは必須ですか? あると助かりますが必須ではありません。ネットワークパネルを開いて実際のリクエストと応答を見るのもグレーボックスです。 小さなチームがブラックボックスだけでよいですか? 可能ですが 2 つ足してください。リリース前の主要経路のリクエスト確認と、レポートにコンソールエラーと失敗リクエストを自動で付けること。どちらも専任を雇うより安く済みます。 3 つのボックスは排他ですか? いいえ。受け入れはブラック、結合はグレー、開発の自己確認はホワイト、と同じ機能で併用するのが一般的です。 「グレーボックスとして十分な報告」かどうかは、どう判断しますか? 開発が追加質問なしで調査を始められるかで判断します。環境、失敗リクエスト、エラー原文が揃っていれば十分です。