---

name: dotnet-testing-advanced
description: .NET 進階測試技能總覽與引導中心。當使用者詢問「整合測試」、「API 測試」、「容器化測試」、「微服務測試」、「測試框架遷移」、「Testcontainers」、「Aspire 測試」等進階測試需求時觸發。會根據具體需求推薦適合的子技能組合，涵蓋整合測試、Testcontainers、Aspire 測試、框架升級等 8 個進階技能。

triggers:
# 入口關鍵字
- integration testing
- 整合測試
- API testing
- API 測試
- advanced testing
- 進階測試
- testcontainers
- aspire testing

# API 與 Web 測試
- WebApplicationFactory
- TestServer
- Controller test
- endpoint test
- HttpClient test
- API 端點測試
- Web API test
- HTTP test
- REST API test
- 控制器測試

# 資料庫測試
- database test
- 資料庫測試
- SQL Server test
- PostgreSQL test
- MySQL test
- EF Core test
- Entity Framework test
- Dapper test
- database integration
- 資料庫整合測試

# NoSQL 資料庫
- MongoDB test
- Redis test
- Elasticsearch test
- NoSQL test
- cache test
- 快取測試
- document database

# 容器化測試
- Docker test
- container test
- 容器測試
- TestcontainersBuilder
- Docker container
- 容器化測試
- containerized testing

# 微服務與分散式
- microservice test
- 微服務測試
- distributed test
- 分散式測試
- .NET Aspire
- DistributedApplication
- service communication
- 服務間通訊

# 框架升級與遷移
- xUnit upgrade
- xUnit 3
- xUnit 3.x
- TUnit
- framework migration
- 框架遷移
- test framework upgrade
- 測試框架升級

license: MIT
metadata:
author: Kevin Tseng
version: "1.0.0"
tags: ".NET, testing, integration, advanced, testcontainers, aspire"
related_skills: "dotnet-testing"
skill_count: 8
skill_type: "overview"

---

.NET 進階測試技能總覽

---

🤖 AI Agent 重要提示

當您（AI Agent）被載入此進階入口 skill 時，請先閱讀以下指引：

📋 本技能的定位

本檔案是「進階測試導航中心」，用於幫助找到正確的進階子技能。

您的任務是

1. ✅ 根據使用者需求匹配對應的進階子技能
2. ✅ 使用 Skill tool 載入具體的子技能
3. ✅ 讓子技能提供專業的整合測試指引

禁止行為

• ❌ 不要在本入口 skill 中直接提供整合測試程式碼
• ❌ 不要在沒有載入子技能的情況下開始實作測試
• ❌ 不要跳過子技能直接提供「一般性」整合測試建議

---

🎯 快速技能對照表（AI Agent 必讀）

使用者提到的關鍵字 → 應載入的進階子技能

整合測試技能

使用者說...	載入指令	用途說明
API 測試、Controller 測試、端點測試	/skill dotnet-testing-advanced-aspnet-integration-testing	基礎 API 整合測試
完整 CRUD、WebAPI 測試、業務流程測試	/skill dotnet-testing-advanced-webapi-integration-testing	完整 API 流程測試
WebApplicationFactory、TestServer	/skill dotnet-testing-advanced-aspnet-integration-testing	WebApplicationFactory 使用

容器化測試技能

使用者說...	載入指令	用途說明
SQL Server 容器、PostgreSQL、MySQL	/skill dotnet-testing-advanced-testcontainers-database	關聯式資料庫容器測試
MongoDB、Redis、Elasticsearch	/skill dotnet-testing-advanced-testcontainers-nosql	NoSQL 資料庫容器測試
真實資料庫、EF Core 測試、Dapper 測試	/skill dotnet-testing-advanced-testcontainers-database	真實資料庫行為測試
Testcontainers、容器測試、Docker 測試	/skill dotnet-testing-advanced-testcontainers-database	Testcontainers 基礎

微服務測試技能

使用者說...	載入指令	用途說明
.NET Aspire、微服務測試、分散式測試	/skill dotnet-testing-advanced-aspire-testing	Aspire 微服務測試
DistributedApplication、服務間通訊	/skill dotnet-testing-advanced-aspire-testing	Aspire 應用測試

框架升級技能

使用者說...	載入指令	用途說明
xUnit 升級、xUnit 3.x、版本升級	/skill dotnet-testing-advanced-xunit-upgrade-guide	xUnit 2.x → 3.x 升級
TUnit、新測試框架、TUnit 基礎	/skill dotnet-testing-advanced-tunit-fundamentals	TUnit 基礎與遷移
TUnit 進階、TUnit DI、平行執行	/skill dotnet-testing-advanced-tunit-advanced	TUnit 進階功能

---

⚠️ 使用流程範例

✅ 正確流程

使用者：請幫我建立 ProductsController 的 API 整合測試

AI：我注意到您需要進行 API 整合測試。根據快速對照表，
    我應該載入 dotnet-testing-advanced-aspnet-integration-testing skill。

    [使用 Skill tool 載入子技能]

AI：現在按照 ASP.NET Core Integration Testing skill 的指引為您建立測試...

❌ 錯誤流程

使用者：請幫我建立 ProductsController 的 API 整合測試

AI：好的，我來寫整合測試...（直接開始寫程式碼，沒有載入子技能）

---

📚 完整技能清單

如需查看完整的 8 個進階技能清單、詳細決策樹、學習路徑建議，請繼續閱讀本檔案後續內容。

人類開發者參考：如需快速查找，請查看 SKILLS_QUICK_INDEX.md

---

適用情境

當您需要以下進階測試能力時，我會協助您找到正確的技能：

• 測試完整的 Web API 端點與 HTTP 流程
• 在測試中使用真實的資料庫（容器化）
• 測試 NoSQL 資料庫（MongoDB、Redis 等）
• 測試微服務架構與分散式系統
• 升級測試框架版本（xUnit 2.x → 3.x）
• 遷移到新測試框架（TUnit）
• 建立端到端的整合測試

快速決策樹

我需要哪種進階測試？

情境 1：測試 ASP.NET Core Web API

選項 A - 基礎 API 測試
→ dotnet-testing-advanced-aspnet-integration-testing

適合：
- 簡單的 API 端點測試
- 不需要真實資料庫（使用記憶體資料庫）
- 測試路由、模型綁定、HTTP 回應

涵蓋內容：
- WebApplicationFactory 使用
- TestServer 設定
- HTTP 回應驗證
- 記憶體資料庫配置

---

選項 B - 完整的 WebAPI 流程測試
→ dotnet-testing-advanced-webapi-integration-testing

適合：
- 完整的 CRUD API 測試
- 需要測試完整的業務流程
- 需要測試資料準備與清理

涵蓋內容：
- 完整的 GET、POST、PUT、DELETE 測試
- 錯誤處理驗證
- 測試基底類別模式
- 資料準備策略

---

情境 2：測試需要真實資料庫

選項 A - 關聯式資料庫（SQL Server、PostgreSQL、MySQL）
→ dotnet-testing-advanced-testcontainers-database

適合：
- Entity Framework Core 測試
- Dapper 測試
- 真實資料庫行為驗證
- 需要測試資料庫特定功能（stored procedures、triggers 等）

支援資料庫：
- SQL Server
- PostgreSQL
- MySQL
- MariaDB

---

選項 B - NoSQL 資料庫（MongoDB、Redis、Elasticsearch）
→ dotnet-testing-advanced-testcontainers-nosql

適合：
- MongoDB 文件操作測試
- Redis 快取測試
- Elasticsearch 搜尋測試
- NoSQL 特有功能測試

支援資料庫：
- MongoDB
- Redis
- Elasticsearch

---

情境 3：測試微服務架構

→ dotnet-testing-advanced-aspire-testing

適合：
- .NET Aspire 專案
- 分散式應用測試
- 服務間通訊測試
- 微服務整合測試

涵蓋內容：
- DistributedApplication 測試
- 服務依賴管理
- 跨服務測試
- 測試容器編排

---

情境 4：升級或遷移測試框架

選項 A - xUnit 升級（2.x → 3.x）
→ dotnet-testing-advanced-xunit-upgrade-guide

適合：
- 現有專案使用 xUnit 2.x
- 想升級到 xUnit 3.x
- 了解版本差異

涵蓋內容：
- 重大變更說明
- 升級步驟指引
- 相容性問題處理
- 最佳實踐

---

選項 B - 遷移到 TUnit（基礎）
→ dotnet-testing-advanced-tunit-fundamentals

適合：
- 評估是否遷移到 TUnit
- 了解 TUnit 基礎
- 學習 TUnit 與 xUnit 的差異

涵蓋內容：
- TUnit 核心概念
- 與 xUnit 對比
- 遷移步驟
- 基本使用方式

---

選項 C - TUnit 進階功能
→ dotnet-testing-advanced-tunit-advanced

適合：
- 已使用 TUnit 基礎
- 想深入使用 TUnit 功能
- 需要平行執行、依賴注入等進階特性

涵蓋內容：
- 資料驅動測試
- 依賴注入
- 平行執行控制
- 進階特性

---

技能分類地圖

1. 整合測試（4 個技能）- Web API 測試

技能名稱	測試範圍	資料庫	適用場景
dotnet-testing-advanced-aspnet-integration-testing	WebApplicationFactory、TestServer、HTTP 回應	記憶體資料庫	基礎 API 整合測試
dotnet-testing-advanced-webapi-integration-testing	完整 CRUD、錯誤處理、業務流程	記憶體/真實	真實 API 專案測試
dotnet-testing-advanced-testcontainers-database	SQL Server、PostgreSQL、MySQL	真實（容器化）	需要真實資料庫行為
dotnet-testing-advanced-testcontainers-nosql	MongoDB、Redis、Elasticsearch	真實（容器化）	NoSQL 資料庫測試

技能詳細說明

aspnet-integration-testing

核心價值：
- 學習 WebApplicationFactory 基礎
- 理解整合測試概念
- 測試 HTTP 端點而不啟動真實伺服器

適合情境：
- API 端點基礎測試
- 路由驗證
- 中介軟體測試
- 不需要真實資料庫

學習難度：⭐⭐ 中等

前置技能：
- dotnet-testing-unit-test-fundamentals（必須）
- dotnet-testing-awesome-assertions-guide（建議）

---

webapi-integration-testing

核心價值：
- 完整的 API 測試流程
- 測試資料管理策略
- 錯誤處理驗證
- 真實業務場景測試

適合情境：
- 正式專案的 API 測試
- 完整的 CRUD 流程
- 複雜的業務邏輯驗證
- 需要測試資料準備與清理

學習難度：⭐⭐⭐ 中高

前置技能：
- dotnet-testing-advanced-aspnet-integration-testing（必須）
- dotnet-testing-nsubstitute-mocking（建議）

---

testcontainers-database

核心價值：
- 使用真實資料庫測試
- 自動化容器管理
- 測試資料庫特定功能
- 隔離的測試環境

適合情境：
- EF Core 測試
- Dapper 測試
- Stored Procedures 測試
- 資料庫遷移測試

學習難度：⭐⭐⭐ 中高

前置技能：
- dotnet-testing-unit-test-fundamentals（必須）
- Docker 基礎知識（必須）

技術需求：
- Docker Desktop 已安裝
- WSL2（Windows 環境）

---

testcontainers-nosql

核心價值：
- 測試 NoSQL 資料庫操作
- 容器化 NoSQL 環境
- 真實資料庫行為驗證

適合情境：
- MongoDB 文件操作
- Redis 快取邏輯
- Elasticsearch 搜尋功能

學習難度：⭐⭐⭐ 中高

前置技能：
- dotnet-testing-advanced-testcontainers-database（建議）
- NoSQL 資料庫基礎知識

---

2. 微服務測試（1 個技能）- 分散式系統

技能名稱	測試範圍	架構	適用場景
dotnet-testing-advanced-aspire-testing	.NET Aspire 分散式應用	微服務	雲原生、微服務架構

技能詳細說明

aspire-testing

核心價值：
- 測試 .NET Aspire 專案
- 分散式應用整合測試
- 服務依賴管理
- 端到端流程驗證

適合情境：
- .NET Aspire 微服務專案
- 多服務協作測試
- 服務發現測試
- 分散式追蹤驗證

學習難度：⭐⭐⭐⭐ 高

前置技能：
- dotnet-testing-advanced-aspnet-integration-testing（必須）
- dotnet-testing-advanced-testcontainers-database（建議）
- .NET Aspire 基礎知識（必須）

技術需求：
- .NET 8+
- .NET Aspire Workload
- Docker Desktop

涵蓋內容：
- DistributedApplication 測試
- 服務間通訊測試
- 依賴服務管理
- 測試容器編排

---

3. 框架遷移（3 個技能）- 測試框架升級

技能名稱	遷移路徑	難度	適用場景
dotnet-testing-advanced-xunit-upgrade-guide	xUnit 2.x → 3.x	⭐⭐ 中等	升級現有 xUnit 專案
dotnet-testing-advanced-tunit-fundamentals	xUnit → TUnit（基礎）	⭐⭐ 中等	評估或遷移到 TUnit
dotnet-testing-advanced-tunit-advanced	TUnit 進階功能	⭐⭐⭐ 中高	深入使用 TUnit

技能詳細說明

xunit-upgrade-guide

核心價值：
- 了解 xUnit 3.x 新特性
- 處理升級問題
- 遷移步驟指引

適合情境：
- 專案使用 xUnit 2.x
- 想升級到最新版本
- 了解版本差異

學習難度：⭐⭐ 中等

涵蓋內容：
- 重大變更清單
- 套件升級步驟
- 相容性問題處理
- 升級檢查清單

何時升級：
- 需要 xUnit 3.x 新功能
- .NET 9+ 專案
- 解決已知問題

---

tunit-fundamentals

核心價值：
- 了解 TUnit 新世代測試框架
- 學習 TUnit 核心概念
- 評估遷移可行性

適合情境：
- 考慮從 xUnit 遷移
- 新專案選擇測試框架
- 了解現代測試框架

學習難度：⭐⭐ 中等

涵蓋內容：
- TUnit vs xUnit 對比
- 基本測試撰寫
- 屬性與斷言
- 遷移建議

TUnit 優勢：
- 更好的效能
- 原生支援依賴注入
- 更靈活的測試組織
- 現代化的 API 設計

---

tunit-advanced

核心價值：
- 深入使用 TUnit 進階功能
- 平行執行控制
- 依賴注入整合
- 資料驅動測試

適合情境：
- 已使用 TUnit 基礎
- 需要進階功能
- 大型測試專案

學習難度：⭐⭐⭐ 中高

前置技能：
- dotnet-testing-advanced-tunit-fundamentals（必須）

涵蓋內容：
- 進階資料驅動測試
- 依賴注入容器
- 測試執行控制
- 自訂測試框架行為

---

常見任務映射表

任務 1：測試 ASP.NET Core Web API（基礎）

情境：為簡單的 ProductsController 建立整合測試

推薦技能：
- dotnet-testing-advanced-aspnet-integration-testing

適用條件：
- 簡單的 CRUD API
- 不需要真實資料庫
- 測試基本的 HTTP 端點

實施步驟：
1. 建立 CustomWebApplicationFactory
2. 設定記憶體資料庫
3. 撰寫 GET、POST 測試
4. 使用 FluentAssertions.Web 驗證回應

提示詞範例：

請使用 dotnet-testing-advanced-aspnet-integration-testing skill
為我的 ProductsController 建立整合測試。Controller 有 GetAll 和 GetById 兩個端點。

預期程式碼結構：

public class ProductsControllerTests : IClassFixture<CustomWebApplicationFactory>
{
    private readonly HttpClient _client;

    public ProductsControllerTests(CustomWebApplicationFactory factory)
    {
        _client = factory.CreateClient();
    }

    [Fact]
    public async Task GetAll_ShouldReturnProducts()
    {
        // Act
        var response = await _client.GetAsync("/api/products");

        // Assert
        response.Should().Be200Ok();
        var products = await response.Content.ReadFromJsonAsync<List<Product>>();
        products.Should().NotBeEmpty();
    }
}

---

任務 2：測試 ASP.NET Core Web API（完整流程）

情境：為 ShippersController 建立完整的 CRUD 測試

推薦技能：
- dotnet-testing-advanced-webapi-integration-testing

適用條件：
- 完整的 CRUD API
- 需要測試錯誤處理
- 需要測試資料準備與清理

實施步驟：
1. 建立測試基底類別（BaseIntegrationTest）
2. 實作 IAsyncLifetime 進行資料準備/清理
3. 測試所有 CRUD 端點
4. 驗證錯誤處理（404、400、409 等）

提示詞範例：

請使用 dotnet-testing-advanced-webapi-integration-testing skill
為我的 ShippersController 建立完整的 CRUD 測試。需要測試：
- GET /api/shippers（取得所有）
- GET /api/shippers/{id}（取得單一）
- POST /api/shippers（新增）
- PUT /api/shippers/{id}（更新）
- DELETE /api/shippers/{id}（刪除）
並且驗證錯誤情境（如找不到資源）。

預期測試涵蓋：
- ✅ GET 成功回傳資料
- ✅ GET 不存在的 ID 回傳 404
- ✅ POST 新增成功
- ✅ POST 無效資料回傳 400
- ✅ PUT 更新成功
- ✅ PUT 不存在的 ID 回傳 404
- ✅ DELETE 刪除成功
- ✅ DELETE 不存在的 ID 回傳 404

---

任務 3：測試需要真實資料庫的程式碼（SQL）

情境：測試 OrderRepository（使用 SQL Server）

推薦技能：
- dotnet-testing-advanced-testcontainers-database

適用條件：
- 使用 EF Core 或 Dapper
- 需要測試真實資料庫行為
- 需要測試資料庫特定功能

實施步驟：
1. 設定 Testcontainers.MsSql
2. 執行資料庫遷移
3. 測試 Repository 方法
4. 每個測試後清理資料

提示詞範例：

請使用 dotnet-testing-advanced-testcontainers-database skill
為我的 OrderRepository 建立測試。Repository 使用 EF Core 連接 SQL Server。
需要測試 GetById、Create、Update、Delete 方法。

預期程式碼結構：

public class OrderRepositoryTests : IAsyncLifetime
{
    private MsSqlContainer _container;
    private OrderDbContext _context;
    private OrderRepository _sut;

    public async Task InitializeAsync()
    {
        // 啟動 SQL Server 容器
        _container = new MsSqlBuilder().Build();
        await _container.StartAsync();

        // 建立 DbContext
        var options = new DbContextOptionsBuilder<OrderDbContext>()
            .UseSqlServer(_container.GetConnectionString())
            .Options;

        _context = new OrderDbContext(options);
        await _context.Database.MigrateAsync();

        _sut = new OrderRepository(_context);
    }

    [Fact]
    public async Task GetById_ExistingOrder_ShouldReturnOrder()
    {
        // Arrange
        var order = new Order { /* ... */ };
        await _context.Orders.AddAsync(order);
        await _context.SaveChangesAsync();

        // Act
        var result = await _sut.GetById(order.Id);

        // Assert
        result.Should().NotBeNull();
        result.Id.Should().Be(order.Id);
    }

    public async Task DisposeAsync()
    {
        await _container.DisposeAsync();
    }
}

---

任務 4：測試 NoSQL 資料庫（MongoDB、Redis）

情境：測試 CacheService（使用 Redis）

推薦技能：
- dotnet-testing-advanced-testcontainers-nosql

適用條件：
- 使用 MongoDB、Redis、Elasticsearch
- 需要測試 NoSQL 特定功能

實施步驟：
1. 設定 Testcontainers.Redis
2. 測試快取邏輯
3. 驗證過期時間
4. 測試快取失效

提示詞範例：

請使用 dotnet-testing-advanced-testcontainers-nosql skill
為我的 CacheService 建立測試。Service 使用 Redis 做快取。
需要測試 Set、Get、Remove 以及過期時間。

預期測試涵蓋：
- ✅ Set 成功儲存資料
- ✅ Get 成功取得資料
- ✅ Get 不存在的鍵回傳 null
- ✅ 過期時間正確運作
- ✅ Remove 成功移除資料

---

任務 5：測試微服務架構（.NET Aspire）

情境：測試 .NET Aspire 微服務專案

推薦技能：
- dotnet-testing-advanced-aspire-testing

適用條件：
- 使用 .NET Aspire
- 多服務協作
- 分散式應用

實施步驟：
1. 建立 DistributedApplication 測試
2. 設定服務依賴
3. 測試服務間通訊
4. 驗證完整流程

提示詞範例：

請使用 dotnet-testing-advanced-aspire-testing skill
為我的 .NET Aspire 專案建立測試。專案包含 API Service 和 Worker Service。
需要測試兩個服務的協作。

---

任務 6：升級 xUnit 到 3.x

情境：現有專案使用 xUnit 2.9.x，想升級到 3.x

推薦技能：
- dotnet-testing-advanced-xunit-upgrade-guide

實施步驟：
1. 了解重大變更
2. 更新套件版本
3. 處理相容性問題
4. 驗證測試執行

提示詞範例：

請使用 dotnet-testing-advanced-xunit-upgrade-guide skill
協助我升級專案中的 xUnit 到 3.x 版本。目前使用 2.9.2。

---

任務 7：評估是否遷移到 TUnit

情境：考慮從 xUnit 遷移到 TUnit

推薦技能：
1. dotnet-testing-advanced-tunit-fundamentals（了解基礎）
2. dotnet-testing-advanced-tunit-advanced（評估進階功能）

實施步驟：
1. 了解 TUnit 與 xUnit 差異
2. 評估遷移成本
3. 試驗性遷移一個測試檔案
4. 決定是否全面遷移

提示詞範例：

請使用 dotnet-testing-advanced-tunit-fundamentals skill
評估是否應將專案從 xUnit 遷移到 TUnit。專案目前有 500+ 測試。

---

整合測試層級對應

根據專案複雜度，選擇適合的測試策略：

Level 1：簡單的 WebApi 專案

專案特徵：
- 簡單的 CRUD API
- 無外部依賴或使用記憶體實作
- 業務邏輯簡單

推薦技能：
- dotnet-testing-advanced-aspnet-integration-testing

測試重點：
- 路由驗證
- 模型綁定
- HTTP 回應
- 基本業務邏輯

範例專案：
- TodoList API
- 簡單的產品目錄

---

Level 2：相依 Service 的 WebApi 專案

專案特徵：
- 有業務邏輯層（Services）
- 依賴外部服務（可以 Mock）
- 中等複雜度

推薦技能組合：
1. dotnet-testing-advanced-aspnet-integration-testing（基礎）
2. dotnet-testing-nsubstitute-mocking（模擬依賴）

測試策略：
- 使用 NSubstitute 建立 Service stub
- 測試 Controller 與 Service 的互動
- 驗證錯誤處理

範例專案：
- 電商 API（有庫存、訂單服務）
- CMS 系統

---

Level 3：完整的 WebApi 專案

專案特徵：
- 複雜的業務邏輯
- 需要真實資料庫
- 可能有外部 API 整合
- 完整的錯誤處理

推薦技能組合：
1. dotnet-testing-advanced-webapi-integration-testing（完整流程）
2. dotnet-testing-advanced-testcontainers-database（真實資料庫）
3. dotnet-testing-advanced-testcontainers-nosql（如有使用 NoSQL）

測試策略：
- 使用 Testcontainers 建立真實資料庫
- 完整的端到端測試
- 測試資料準備與清理
- 驗證所有錯誤情境

範例專案：
- 大型電商平台
- 企業級管理系統
- SaaS 應用

---

學習路徑建議

整合測試入門（1 週）

目標：掌握整合測試基礎，能為 Web API 建立測試

Day 1-2：基礎整合測試

技能：dotnet-testing-advanced-aspnet-integration-testing

學習重點：
- WebApplicationFactory 概念
- TestServer 使用
- HTTP 回應驗證
- 記憶體資料庫配置

實作練習：
- 為簡單的 API 建立整合測試
- 測試 GET、POST 端點

---

Day 3-4：完整 WebAPI 測試

技能：dotnet-testing-advanced-webapi-integration-testing

學習重點：
- 完整 CRUD 測試
- 測試基底類別設計
- 資料準備與清理
- 錯誤處理驗證

實作練習：
- 為完整的 Controller 建立測試
- 實作測試資料管理

---

Day 5-6：容器化資料庫測試

技能：dotnet-testing-advanced-testcontainers-database

學習重點：
- Testcontainers 概念
- SQL Server 容器設定
- 資料庫遷移執行
- 測試隔離

實作練習：
- 為 Repository 建立測試
- 使用真實資料庫

---

Day 7：NoSQL 資料庫測試

技能：dotnet-testing-advanced-testcontainers-nosql

學習重點：
- MongoDB 容器設定
- Redis 容器設定
- NoSQL 特定測試模式

實作練習：
- 測試 MongoDB Repository
- 測試 Redis Cache Service

---

微服務測試專精（3-5 天）

前置條件：完成整合測試入門

技能：dotnet-testing-advanced-aspire-testing

學習重點：
- .NET Aspire 架構理解
- DistributedApplication 測試
- 服務依賴管理
- 分散式測試策略

實作練習：
- 測試 Aspire 微服務專案
- 驗證服務間通訊

---

框架遷移路徑（依需求）

xUnit 升級（1-2 天）

技能：dotnet-testing-advanced-xunit-upgrade-guide

學習重點：
- xUnit 3.x 新特性
- 重大變更處理
- 升級步驟
- 相容性測試

實施步驟：
1. 了解版本差異
2. 更新套件
3. 處理編譯錯誤
4. 驗證測試執行

---

TUnit 遷移（2-5 天）

基礎（2-3 天）
技能：dotnet-testing-advanced-tunit-fundamentals

學習重點：
- TUnit 核心概念
- 與 xUnit 對比
- 基本測試撰寫
- 遷移建議

---

進階（2-3 天）
技能：dotnet-testing-advanced-tunit-advanced

學習重點：
- 資料驅動測試
- 依賴注入
- 平行執行控制
- 進階特性

---

技能組合建議

根據不同的專案需求，推薦以下技能組合：

組合 1：完整 API 測試專案

適合：建立正式專案的完整測試套件

技能組合：
1. dotnet-testing-advanced-aspnet-integration-testing（基礎）
2. dotnet-testing-advanced-testcontainers-database（真實資料庫）
3. dotnet-testing-advanced-webapi-integration-testing（完整流程）

學習順序：
1. 先學 aspnet-integration-testing 理解基礎
2. 再學 testcontainers-database 掌握資料庫測試
3. 最後學 webapi-integration-testing 整合應用

預期成果：
- 能為 Web API 專案建立完整測試
- 使用真實資料庫驗證行為
- 測試所有 CRUD 端點與錯誤處理

---

組合 2：微服務測試方案

適合：微服務架構、分散式系統

技能組合：
1. dotnet-testing-advanced-aspire-testing（核心）
2. dotnet-testing-advanced-testcontainers-database（資料庫）
3. dotnet-testing-advanced-testcontainers-nosql（NoSQL）

學習順序：
1. 先學 testcontainers（資料庫測試基礎）
2. 再學 aspire-testing（微服務測試）

預期成果：
- 測試 .NET Aspire 專案
- 驗證服務間通訊
- 使用容器化環境測試

---

組合 3：框架現代化

適合：測試框架升級或遷移

選項 A：xUnit 升級

技能：
- dotnet-testing-advanced-xunit-upgrade-guide

適合：
- 現有專案使用 xUnit 2.x
- 想升級到最新版本

---

選項 B：TUnit 遷移

技能組合：
1. dotnet-testing-advanced-tunit-fundamentals（基礎）
2. dotnet-testing-advanced-tunit-advanced（進階）

適合：
- 新專案選擇測試框架
- 考慮從 xUnit 遷移

學習順序：
1. 先學 fundamentals 了解基礎
2. 再學 advanced 掌握進階功能

---

前置技能要求

學習進階技能前，建議先掌握以下基礎技能（來自 dotnet-testing 基礎技能集）：

必備技能

1. dotnet-testing-unit-test-fundamentals

為什麼必須：
- 整合測試也遵循 3A Pattern
- FIRST 原則同樣適用
- 需要理解測試基礎概念

---

2. dotnet-testing-xunit-project-setup

為什麼必須：
- 需要建立測試專案
- 理解專案結構
- 了解套件管理

---

3. dotnet-testing-awesome-assertions-guide

為什麼必須：
- 整合測試需要驗證 HTTP 回應
- FluentAssertions.Web 提供強大的 API 斷言
- 提升測試可讀性

---

推薦技能

1. dotnet-testing-nsubstitute-mocking

為什麼推薦：
- 整合測試中可能需要 Mock 外部服務
- WebApplicationFactory 需要替換服務

---

2. dotnet-testing-autofixture-basics

為什麼推薦：
- 快速產生測試資料
- 減少整合測試的樣板程式碼

---

引導對話範例

以下範例展示 AI 如何與您互動，幫助您選擇正確的進階技能。

範例 1：API 測試需求

您：我想測試 Web API

AI：我會協助您建立 Web API 測試！請先確認您的測試需求：

1. API 複雜度：
- [ ] 簡單的 API（幾個端點）
- [ ] 中型 API（完整的 CRUD）
- [ ] 複雜 API（多層架構、複雜業務邏輯）

2. 資料庫需求：
- [ ] 不需要資料庫
- [ ] 記憶體資料庫即可
- [ ] 需要真實資料庫

3. 資料庫類型（如需要真實資料庫）：
- [ ] SQL Server / PostgreSQL / MySQL
- [ ] MongoDB / Redis / Elasticsearch
- [ ] 兩者都有

請告訴我您的選擇，我會推薦適合的技能組合。

---

您：中型 API，需要真實的 SQL Server 資料庫

AI：完美！根據您的需求，我推薦以下技能組合：

第一步：學習基礎整合測試（1-2 天）
dotnet-testing-advanced-aspnet-integration-testing
- 理解 WebApplicationFactory
- 學習 HTTP 測試基礎

第二步：加入真實資料庫（2 天）
dotnet-testing-advanced-testcontainers-database
- 使用 Testcontainers 設定 SQL Server
- 學習資料庫測試隔離

第三步：完整流程測試（2-3 天）
dotnet-testing-advanced-webapi-integration-testing
- 實作完整的 CRUD 測試
- 測試資料管理策略
- 錯誤處理驗證

預期成果：
完成後您將能夠為 API 專案建立完整的整合測試套件，使用真實的 SQL Server 資料庫驗證行為。

需要我使用這些 skills 協助您開始嗎？

---

範例 2：微服務測試

您：我的專案是 .NET Aspire 微服務架構，要怎麼測試？

AI：.NET Aspire 微服務測試需要特殊的方法！我推薦使用 dotnet-testing-advanced-aspire-testing skill。

前置確認：
1. 您已安裝 .NET Aspire Workload？
- 如果沒有：dotnet workload install aspire

1. 您的專案有哪些服務？
2. API Service
3. Worker Service

4. 其他服務

5. 是否使用資料庫？

6. 如果有，我們會搭配 dotnet-testing-advanced-testcontainers-database

測試重點：
- DistributedApplication 測試
- 服務間通訊驗證
- 依賴服務管理
- 端到端流程測試

需要我使用 dotnet-testing-advanced-aspire-testing skill 協助您建立測試嗎？

---

範例 3：框架升級

您：我的專案使用 xUnit 2.9，應該升級到 3.x 嗎？

AI：這是個好問題！我會協助您評估。讓我先了解您的情況：

1. 升級動機：
- [ ] 需要 xUnit 3.x 的新功能
- [ ] 解決已知問題
- [ ] 只是想跟上最新版本
- [ ] 其他原因

2. 專案規模：
- [ ] 小型（< 100 個測試）
- [ ] 中型（100-500 個測試）
- [ ] 大型（> 500 個測試）

3. 升級時程壓力：
- [ ] 不急，可以慢慢遷移
- [ ] 需要儘快完成

---

您：中型專案，主要是想跟上最新版本，不急

AI：了解！我推薦使用 dotnet-testing-advanced-xunit-upgrade-guide skill。

升級計劃：

階段 1：了解差異（1 天）
- 閱讀重大變更清單
- 了解哪些功能受影響
- 評估遷移工作量

階段 2：準備升級（半天）
- 備份目前程式碼
- 更新 .csproj 套件版本
- 檢查編譯錯誤

階段 3：處理相容性（1-2 天）
- 修正編譯錯誤
- 處理執行階段問題
- 驗證所有測試通過

總工時估計：2-3 天

風險評估：⭐⭐ 中低
xUnit 3.x 升級通常很順利，大部分變更都有向後相容。

需要我使用 dotnet-testing-advanced-xunit-upgrade-guide skill 協助您開始升級嗎？

---

範例 4：TUnit 評估

您：我聽說 TUnit 很不錯，應該遷移嗎？

AI：TUnit 確實是很有潛力的測試框架！讓我協助您評估。

TUnit 主要優勢：
1. ⚡ 更好的效能：平行執行優化
2. 💉 原生依賴注入：不需要額外設定
3. 🎯 現代化 API：更直覺的設計
4. 🔧 靈活性：更多自訂選項

評估重點：

1. 專案狀況：
- 新專案 → 可以考慮直接使用 TUnit
- 現有專案 → 需評估遷移成本

2. 團隊技能：
- 團隊對 xUnit 熟悉度
- 學習新框架的意願

3. 遷移成本：
- 測試數量
- 特殊測試模式（如 Theory、ClassFixture 等）

我的建議：

如果是新專案：
使用 dotnet-testing-advanced-tunit-fundamentals skill 了解 TUnit，考慮直接採用。

如果是現有專案：
1. 先用 dotnet-testing-advanced-tunit-fundamentals 了解基礎
2. 試驗性遷移一個測試檔案
3. 評估實際遷移工作量
4. 決定是否全面遷移

需要我協助您評估嗎？

---

與基礎技能的關係

進階技能建立在基礎技能之上：

基礎測試能力 → dotnet-testing（基礎技能集）
- 單元測試基礎
- 測試資料生成
- 斷言與模擬
- 特殊場景處理

↓ 進階應用

進階整合測試 → dotnet-testing-advanced（本技能集）
- Web API 整合測試
- 容器化測試
- 微服務測試
- 框架升級

學習建議：
先完成 dotnet-testing 基礎技能集的核心技能，再進入本進階技能集。

---

相關資源

原始資料來源

• iThome 鐵人賽系列文章：老派軟體工程師的測試修練 - 30 天挑戰
  🏆 2025 iThome 鐵人賽 Software Development 組冠軍

• 完整範例程式碼：30Days_in_Testing_Samples
  包含所有範例專案的可執行程式碼

技術需求

整合測試技能：
- .NET 8+
- Docker Desktop
- WSL2（Windows 環境）

Aspire 測試技能：
- .NET 8+
- .NET Aspire Workload
- Docker Desktop

---

下一步

選擇符合您需求的進階技能開始學習，或告訴我您的具體情況，我會推薦最適合的學習路徑！

快速開始：
- 想測試 API → 從 dotnet-testing-advanced-aspnet-integration-testing 開始
- 需要真實資料庫 → 從 dotnet-testing-advanced-testcontainers-database 開始
- 微服務專案 → 使用 dotnet-testing-advanced-aspire-testing
- 框架升級 → 使用對應的升級指南
- 不確定 → 告訴我您的專案情況，我會幫您分析