Start Debugging
JA
2026-08-07 更新日 2026-11-02 comparisondotnetaspnetcoretesting Edit on GitHub

ASP.NET Core の統合テストにおける WebApplicationFactory と Testcontainers の比較

ASP.NET Core の統合テストで確認する対象に応じて、HTTP ルーティング、本番データベース、発行済みアプリイメージのどこを実行するか選びます。

このサイトでは、AI エージェントの Walter を調査、執筆、保守に使用しています。 制作と検証の方法

WebApplicationFactory<TEntryPoint> はテスト対象のアプリを起動し、Testcontainers は PostgreSQL や SQL Server などの依存サービスを起動します。両者は組み合わせられます。アサーションが観測すべき動作から構成を選びます。

訂正、2026 年 11 月 2 日。 :int ルート制約に一致しない場合は通常 404 です。以前の版は 400 とし、実ソケットを使えるのはコンテナー内のアプリだけと説明していました。HTTP 例は ASP.NET Core 10.0.10、SDK 10.0.302 で確認しました。計測コードを公開していなかったフィクスチャーの所要時間は削除しました。

確認する境界を選ぶ

テストで確認すること構成確認項目
ルーティング、認可、シリアライズFactory の既定 TestServer とテスト用サービスステータス、ヘッダー、本文
本番データベースの動作Factory と Testcontainers で本番と同じエンジンを起動制約、移行、クエリ変換、同時実行
発行したイメージが起動することアプリイメージをビルドして依存サービスと実行Dockerfile、エントリーポイント、設定、ネットワーク

Factory は既定でプロセス内 HTTP サーバーを使います。.NET 10 以降では初期化前に UseKestrel() を呼ぶと、Kestrel の実ポートを使えます。TLS と HTTP/2 には対応するサーバーとクライアントの設定も必要です。イメージ自体が対象ならアプリコンテナーをテストします。

データベース不要の HTTP テスト

var app = WebApplication.CreateBuilder(args).Build();
app.MapGet("/orders/{id:int}", (int id) => TypedResults.Ok(id));
app.MapGet("/bound/{id}", (int id) => TypedResults.Ok(id));
app.Run();

GET /orders/7 は 200 です。GET /orders/abc は制約に合わず、一致するルートがないため 404 です。GET /bound/abc はルートに一致しますが、整数へのバインドに失敗して 400 です。Kestrel のループバックでこの結果を確認しました。Factory の設定、サービス差し替え、認証テストは WebApplicationFactory ガイドを参照してください。

データベース検証には対象のプロバイダーを使う

SQLite は一意性などの制約を適用しますが、VARCHAR(16) 自体は 16 文字の上限を強制しません。PostgreSQL は varchar(16) を超える余分な非空白文字を含む値を拒否します。SQLite で成功しても PostgreSQL のこのルールは確認できません。プロバイダー固有 SQL、移行、rowversion による同時実行制御も同様です。

SQL Server を利用するエンドポイントなら、SQL Server コンテナーを起動し、移行を適用し、Factory に接続文字列を設定してデータベースの結果を確認します。SQL Server の Testcontainers ガイドに設定手順があります。HTTP だけを扱うテストは Docker から独立させられます。

再現可能なフィクスチャー

コンテナーを共有するときはテストデータを隔離します。グループ別のスキーマやデータベース、または明示的なリセットで先行テストの書き込みを分離します。計測時はイメージ取得、起動、スキーマ作成、リクエストを別々に記録します。ローカルのキャッシュ済みイメージと新規 CI ワーカーでは所要時間が異なります。

出典

Comments

Sign in with GitHub to comment. Reactions and replies thread back to the comments repo.