ブラックボックステストは入力と出力だけを見て、コードの書き方には関心を持ちません。ホワイトボックステストはコードと分岐を読みます。グレーボックステストはその中間で、テストする人は内部情報の一部(API、ログ、データ構造、計測イベント)を知っていますが、実装を行単位で読むことはしません。 3 つは同じ機能をテストします。違うのは、内部情報をどれだけ持っているか、そしてその結果としてどんな問いを立てられるかです。 選び間違えると具体的なコストが出ます。グレーボックスでしか見えない問題(フィールドの型が変わった、など)をブラックボックスで探しても、100 回試して見つかりません。逆に、業務テスターにコードを読むよう求めるのは、テストを開発の片手間仕事にしてしまいます。
3 つのボックスの比較
| 観点 | ブラックボックス | グレーボックス | ホワイトボックス |
|---|---|---|---|
| 内部知識 | ほぼなし。要件と画面だけ | API、ログ、データ構造、実装の一部 | コードと構造の全体 |
| 何を検証するか | 振る舞いが期待どおりか | 振る舞い+内部の整合性 | 分岐、境界、網羅性 |
| 誰がやるか | 業務テスター、プロダクト、カスタマーサクセス | API を知るテスター、開発 | 開発 |
| 代表的な手法 | 同値分割、境界値、決定表、状態遷移、ペアワイズ | API 検証、ログ照合、計測の検証、契約テスト | 単体テスト、カバレッジ、静的解析 |
| コスト | 最小。すぐ始められる | 中。環境とドキュメントが必要 | 最大。コードを読む必要がある |
| 見落とすもの | 特定のデータや環境でだけ出る問題 | システム間のタイミング問題 | 利用者が気づかない問題 |
ブラックボックスの 5 手法
ログインフォームを例にします。Web チームでのグレーボックスの実践
コードを読む必要はありません。開発者ツールで足ります。- リクエストを見る:ネットワークで、API が 200 でもフィールドが変わっている、あるいは 4xx / 5xx を返していることを確認する。
- エラーを見る:コンソールの赤い表示は、画面上の症状より原因に近いことが多い。
- 契約を見る:API ドキュメントが
price: numberなのに、応答が"12.00"。これはグレーボックスでしか見つからない。
- 計測を見る:送信されていないイベントは画面では見えませんが、意思決定を歪めます。
ブラックボックスの報告が差し戻される理由
証拠が足りないからです。同じ事象を 2 通りで書きます。| 書き方 | 開発が次にすること |
|---|---|
| 「ログインを押しても何も起きない」 | どのアカウント、どのブラウザ、コンソールに赤い表示はあるかを聞く |
「Chrome 141 / Windows 11。テストアカウント A が https://example.com/login で正しいパスワードを入力してログインを押すが遷移しない。ネットワークで POST /api/login が 500、コンソールに Unhandled promise rejection」 |
そのままサーバーログを見に行く |
ブラックボックスで足りるとき、グレーが必須のとき
| 場面 | 推奨 | 理由 |
|---|---|---|
| 新機能が要件どおりかの受け入れ | ブラックボックス | 見るのは振る舞いで、実装ではない |
| リリース前の回帰確認 | ブラックボックス+主要経路はグレー | 流れは振る舞い、ログインと決済はリクエスト |
| API フィールド変更、結合確認 | グレーボックス | 画面は正常に見えてもデータがすでに違う |
| 性能とタイムアウト | グレーボックス | リクエストの所要時間と失敗率が必要 |
| セキュリティと権限 | 主にグレーボックス | 権限昇格は画面上ほぼ見えない |
| 静的ページ、文言変更 | ブラックボックス | 内部の連鎖がない |
例:決済コールバックを 3 つの視点で見る
同じ症状でも、答えの深さが 3 段階になります。- ブラックボックス:顧客は決済を完了したのに、注文は「支払い待ち」のまま。振る舞いが期待と違うので起票する。
- グレーボックス:ネットワークで
POST /api/pay/callbackは 200 だが、本文のstatusがpending。コンソールは静か。問題はサーバー側の状態処理で、フロントではない。
- ホワイトボックス:コールバック処理はログを書いてから注文を更新し、更新失敗を空の
catchが飲み込んでいる。論理的な欠陥で、同種の問題が他にもある可能性が高い。
ボックスをテスト計画に書き込む
| 段階 | 主なボックス | 成果物 |
|---|---|---|
| 要件レビュー後 | ブラックボックス | ケース設計と受け入れ基準 |
| 結合・初回ビルド | グレーボックス | 契約確認、フィールドとエラーコードの一覧 |
| リリース前の回帰 | ブラックボックス+主要経路はグレー | 回帰チェックリスト、主要経路のリクエスト記録 |
| リリース後 | グレー(ログと監視)+ブラック(実際の声) | アラート規則、利用者からの報告 |
グレーボックスの 3 つの前提
グレーボックスは宣言して始められるものではありません。どれか 1 つ欠けるとブラックボックスに戻ります。よくある 3 つの誤解
- ホワイトボックス=単体テスト:最も典型的な用途ですが、コードレビュー、カバレッジ分析、静的スキャンも含みます。
- グレーボックス=コードを読む:中心は内部情報を知ること。ログやリクエストを見るのは該当し、実装を読む必要はありません。
- 自動化=ホワイトボックス:UI 自動化は通常ブラックボックス(画面を操作するだけ)で、API 自動化はグレーに近いです。手法とボックスは別の軸です。