dotnet-testing-advanced-aspire-testing

name

dotnet-testing-advanced-aspire-testing

description

.NET Aspire Testing 整合測試框架完整指南。當需要測試 .NET Aspire 分散式應用程式、設定 AppHost 測試或從 Testcontainers 遷移至 Aspire 測試時使用。涵蓋 DistributedApplicationTestingBuilder、容器生命週期管理、多服務編排、Respawn 配置與時間可測試性設計。 Make sure to use this skill whenever the user mentions .NET Aspire, AppHost testing, DistributedApplicationTestingBuilder, cloud-native testing, or migrating from Testcontainers to Aspire, even if they don't explicitly ask for Aspire testing guidance. Keywords: aspire testing, .NET Aspire, DistributedApplicationTestingBuilder, AppHost testing, 分散式測試, AspireAppFixture, IAsyncLifetime, ContainerLifetime.Session, 雲原生測試, 多服務整合, Aspire.Hosting.Testing, Respawn

.NET Aspire Testing 整合測試框架

前置需求

• .NET 8 SDK 或更高版本
• Docker Desktop（WSL 2 或 Hyper-V）
• AppHost 專案（.NET Aspire 應用編排）

核心概念

.NET Aspire Testing 定位

.NET Aspire Testing 是封閉式整合測試框架，專為分散式應用設計：

• 在測試中重現與正式環境相同的服務架構
• 使用真實容器而非模擬服務
• 自動管理容器生命週期

AppHost 專案的必要性

使用 .NET Aspire Testing 必須建立 AppHost 專案：

• 定義完整的應用架構和容器編排
• 測試重用 AppHost 配置建立環境
• 沒有 AppHost 就無法使用 Aspire Testing

與 Testcontainers 的差異

特性	.NET Aspire Testing	Testcontainers
設計目標	雲原生分散式應用	通用容器測試
配置方式	AppHost 宣告式定義	程式碼手動配置
服務編排	自動處理	手動管理
學習曲線	較高	中等
適用場景	已用 Aspire 的專案	傳統 Web API

專案結構

MyApp/
├── src/
│   ├── MyApp.Api/                    # WebApi 層
│   ├── MyApp.Application/            # 應用服務層
│   ├── MyApp.Domain/                 # 領域模型
│   └── MyApp.Infrastructure/         # 基礎設施層
├── MyApp.AppHost/                    # Aspire 編排專案 ⭐
│   ├── MyApp.AppHost.csproj
│   └── Program.cs
└── tests/
    └── MyApp.Tests.Integration/      # Aspire Testing 整合測試
        ├── MyApp.Tests.Integration.csproj
        ├── Infrastructure/
        │   ├── AspireAppFixture.cs
        │   ├── IntegrationTestCollection.cs
        │   ├── IntegrationTestBase.cs
        │   └── DatabaseManager.cs
        └── Controllers/
            └── MyControllerTests.cs