# 結合テストとは

モジュールの間や他のシステムとの間で、データを期待どおりに受け渡しできるかを確認するテストです。連携の相手の環境や担当者の日程が、テストの計画と品質を左右します。

## 結合テストとは

結合テストは、個別に作成したモジュールを結合し、モジュールの間や他のシステムとの間でデータを期待どおりに受け渡しできるかを確認するテストです。
たとえばネット通販のシステムなら、注文の受付、在庫の確保、決済、出荷の指示を結合して確認します。
注文を確定すると在庫の数が減少するかを確認します。
決済の代行会社から失敗の応答を受信したときに、注文を無効にするかも確認します。
倉庫のシステムに指示が指定の時刻までに到着するかも確認の対象です。

単体テストはモジュールを単独で確認します[^jstqb]。
結合テストは、モジュールの間やシステムの間の受け渡しを確認します[^jstqb]。
システムテストは、システム全体の振る舞いが仕様と一致するかを確認します[^jstqb]。
国際的な資格制度の用語では統合テストと呼び、モジュールの間を確認するコンポーネント統合テストと、他のシステムや外部のサービスとの間を確認するシステム統合テストを別のテストレベルとして定義しています[^jstqb]。

![単体テストはモジュール単独、結合テストはモジュールの間と他のシステムとの間の受け渡し、システムテストはシステム全体の振る舞いを確認するという、確認の対象の違いを比較した図](https://media.marketing.kdotdev-tunnel.org/glossary-integration-testing-e7540a2d06dbf6429ea4ccbc13542c4ef6d43512661021ab3114c393b68a23aa.png)

## なぜ必要か

モジュールを単独でテストするときは、連携の相手をテストダブルと呼ぶ代役のプログラムで代用して確認する場合があります。
代役に設定していない応答や、接続先の設定、実際の接続条件による問題は、代役との確認だけでは発見できないことがあります。

こうした問題を完成したシステム全体のテストの段階で初めて発見すると、原因がモジュールの内部の処理か受け渡しの箇所かの特定に時間がかかります。
小さな結合の単位で受け渡しを先に確認しておけば、問題の箇所を特定しやすくなります。

![代役のプログラムとの確認では設定した応答だけを確認し、実際の相手のシステムと結合すると接続の設定と条件も確認できることを対比した図](https://media.marketing.kdotdev-tunnel.org/glossary-integration-testing-2fdd469db973b6ccba4d7a3c2f4d3e5f369962c1b35e96ef2ad61c8042691387.png)

## 結合テストで判明する問題

- データの形式の不一致: 項目の名前、日付や金額の書式、文字コード、空欄の扱いが相手と一致しない
- 異常時の処理（エラー処理）の欠落: 相手が応答しない、失敗を応答した、同じデータが2回到着した、といった場合の処理がない
- 時刻と順序の問題: 夜間の連携の処理が前の処理の完了前に開始する、締めの時刻に処理が完了しない
- 権限と接続の設定: 接続先の指定、証明書、利用の上限の設定に誤りがある

テストの範囲は件数ではなく、在庫や売上に不整合を生じる異常を確認しているかで判断します。
ネット通販の例なら、決済の失敗、応答がない場合、同じ注文の再受信は、在庫と売上の不整合に直結するため確認の対象にします。

![結合テストで判明する問題を、データの形式、異常時の処理、時刻と順序、権限と接続の4種類に区分し、それぞれの典型例を示した図](https://media.marketing.kdotdev-tunnel.org/glossary-integration-testing-e8bbe2099bc38bcde75b3634de840b58665b1d99e6a702377daf3d7b2fe8c0f7.png)

## 連携の相手の環境と日程

他のシステムとの結合テストには、適切なテスト環境が必要で、可能な範囲で本番の環境に近い構成にします[^jstqb]。
連携の相手が社内の別の部署や外部の企業のシステムなら、相手の検証用のテスト環境の有無、利用できる期間、相手の担当者が対応できる日程を、設計の段階で確認しておきます。

- 相手のテスト環境がない場合は、その準備期間が開発の日程を制約することがある
- 決済や配送のような外部のサービスは、検証用の環境の仕様が本番と異なることがある。その差の部分は本番で初めて確認することになる
- 相手の都合で結合テストの開始が延期になると、その連携に依存する後続のテストにも遅延が及ぶことがある

相手の環境や担当者の日程に依存する結合テストは、相手の数に関係なく、開発の計画に最初から組み込みます。

![相手のテスト環境と担当者の日程の2つの準備の完了後に結合テストを実施でき、その遅延が依存する後続のテストに波及することを示した図](https://media.marketing.kdotdev-tunnel.org/glossary-integration-testing-a4d3ae712ebe8b4d020c7e0b06708a009915d81ea1d8b531ec32e1ef44f8793f.png)

## 効果・コスト・リスク

### 効果

- 受け渡しの問題を、システム全体のテストの前に、箇所を特定しやすい形で発見できる
- 異常時の処理を確認することで、稼働後にシステムの間で記録が一致しない事態と、手作業での補正を減少させる
- テストの手順とデータを保存しておくと、改修のたびの再確認に再利用できる[^digital]

### コストとリスク

- 連携の相手のテスト環境を準備する費用と、相手の担当者の時間が必要になる
- 注文、在庫、決済の記録のように、連携するすべてのシステムで整合するテストデータを準備する必要がある
- 相手の都合による日程の遅延は、自社だけでは制御しにくい
- 手作業で反復する確認には実行の費用がかかり、自動化した確認にも連携先の変更に追従する保守が必要になる

![問題の早期発見、稼働後の補正の減少、改修時の再確認への再利用という効果と、相手の環境、テストデータ、日程の遅延、反復と自動化の保守という費用とリスクを対比した図](https://media.marketing.kdotdev-tunnel.org/glossary-integration-testing-d6cce5f01538f6388a2377ce1321adb17dcb7f2097cf9d438406b055623c3947.png)

## 結果の報告と次の工程への移行の判断

結合テストを実施するのは開発チームやテストの担当ですが、次の工程への移行を判断するときは、利用部門や情シスも結果の報告を確認します。
政府のシステムでは、テスト計画書に合否の判定の基準を記載し、すべての基準を満たした場合に限り次の工程の開始を承認します[^digital]。

判断の軸は、不具合の件数ではなく、未解決の問題が後続のテストの結果を無効にするかです。
主要な取引の連携で、後続のテストの実行や結果の判定に支障のあるエラーや応答の遅延が未解決の場合は、移行を延期します。
ネット通販の例なら、注文の確定や決済の連携がこれに該当します。
影響が特定の画面や請求書の出力に限定され、後続のテストの結果に影響しない問題は、修正の期限を設定して移行できます。

検証用の環境で確認できなかった点は、本番で確認する範囲と、失敗した場合の対処を決定しておきます。
ネット通販の例の出荷の指示や決済は、自社のシステムを切り替え前の状態に復旧しても、送信済みの指示は取り消しできません。
こうした処理には誤実行の場合の補正の手順も用意します。

![未解決の問題が後続のテストの結果を無効にするかで、移行の延期と、修正の期限を設定した移行に分岐する判断の流れの図](https://media.marketing.kdotdev-tunnel.org/glossary-integration-testing-ddefa6b480f9dac344a25a67cd9f67c3fe9fd271fe63d9b7843f4ad4800a6f52.png)

## よくある誤解

### 単体テストをすべて通過すれば結合テストの不具合は少ない

単体テストはモジュールの内部の処理を確認するもので、相手との受け渡しは代役で代用して確認する場合があります。
モジュールごとの品質が高くても、実際の相手との形式の不一致や接続の設定の誤りは、結合して初めて判明することがあります。

### 結合テストは外部のシステムとの接続の確認だけである

外部のシステムとの連携と同様に、同じシステムの中のモジュールの間の受け渡しも結合テストの対象です。
注文の受付と在庫の確保のような内部の連携でも、データの形式や処理の順序の不具合は発生します。

[^jstqb]: [JSTQB Foundation Levelシラバス Version 4.0.J02](https://jstqb.jp/dl/JSTQB-SyllabusFoundation_VersionV40.J02.pdf)（JSTQB、2024年7月改訂）。2.2.1 テストレベル
[^digital]: [デジタル・ガバメント推進標準ガイドライン](https://www.digital.go.jp/assets/contents/node/basic_page/field_ref_resources/e2a06143-ed29-4f1d-9c31-0f06fca67afc/d4e68a9b/20250619_resources_standard_guidelines_guideline_01.pdf)（デジタル庁、2025年5月）。第3編第7章 設計・開発
