dotnet-testing-advanced-aspnet-integration-testing

name

dotnet-testing-advanced-aspnet-integration-testing

description

ASP.NET Core 整合測試的專門技能。當需要測試 Web API 端點、HTTP 請求/回應、中介軟體、依賴注入時使用。涵蓋 WebApplicationFactory、TestServer、HttpClient 測試、記憶體資料庫配置等。 Make sure to use this skill whenever the user mentions ASP.NET Core integration testing, WebApplicationFactory, TestServer, HTTP endpoint testing, or middleware testing, even if they don't explicitly ask for integration testing guidance. Keywords: integration testing, 整合測試, web api testing, WebApplicationFactory, TestServer, HttpClient testing, controller testing, endpoint testing, 端點測試, RESTful API testing, Microsoft.AspNetCore.Mvc.Testing, CreateClient, ConfigureWebHost, AwesomeAssertions.Web, Be200Ok, Be404NotFound, middleware testing, 中介軟體測試, dependency injection testing

ASP.NET Core 整合測試指南

核心概念

整合測試的兩種定義

1. 多物件協作測試 — 將兩個以上的類別做整合，測試它們之間的運作是否正確
2. 外部資源整合測試 — 使用到資料庫、外部服務、檔案等外部資源的測試

為什麼需要整合測試？

• 確保多個模組整合後能正確工作
• 單元測試無法涵蓋的整合點：Routing、Middleware、Request/Response Pipeline
• 確認 WebApplication 的整合與設定是否正確
• 確認異常處理是否完善

測試金字塔定位

測試類型	測試範圍	執行速度	維護成本	建議比例
單元測試	單一類別/方法	很快	低	70%
整合測試	多個元件	中等	中等	20%
端對端測試	完整流程	慢	高	10%

原則一：使用 WebApplicationFactory 建立測試環境

透過 WebApplicationFactory<Program> 建立記憶體中的 TestServer，搭配 IClassFixture 在測試類別間共享。

基本流程

1. 測試類別實作 IClassFixture<WebApplicationFactory<Program>>