تشغيل أي مهارة في Manus بنقرة واحدة

dotnet-testing-advanced-testcontainers-database

使用 Testcontainers 進行容器化資料庫測試的專門技能。當需要測試真實資料庫行為、使用 SQL Server/PostgreSQL/MySQL 容器、測試 EF Core/Dapper 時使用。涵蓋容器啟動、資料庫遷移、測試隔離、容器共享等。 Make sure to use this skill whenever the user mentions Testcontainers database, SQL Server container, PostgreSQL container, EF Core integration test, Dapper testing, or Collection Fixture, even if they don't explicitly ask for container-based database testing. Keywords: testcontainers, 容器測試, container testing, database testing, 資料庫測試, MsSqlContainer, PostgreSqlContainer, MySqlContainer, EF Core testing, Dapper testing, Testcontainers.MsSql, Testcontainers.PostgreSql, GetConnectionString, IAsyncLifetime, CollectionFixture

تشغيل في Manus

نظرة عامة

أمر التثبيت

npx skills add https://github.com/kevintsengtw/dotnet-testing-agent-skills --skill dotnet-testing-advanced-testcontainers-database

انسخ والصق هذا الأمر في Claude Code لتثبيت المهارة

المصدر

kevintsengtw/dotnet-testing-agent-skills

النجوم٢٦

التفرعات٤

آخر تحديث٣١ مارس ٢٠٢٦ في ٠٦:٥٩

مستكشف الملفات

8 ملفات

SKILL.md

readonly

المزيد من هذا المستودع

نفس المستودع

dotnet-testing-advanced-aspire-testing

kevintsengtw/dotnet-testing-agent-skills

.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

2026-03-3126

dotnet-testing-advanced-aspnet-integration-testing

kevintsengtw/dotnet-testing-agent-skills

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

2026-03-3126

dotnet-testing-advanced

kevintsengtw/dotnet-testing-agent-skills

.NET 進階測試技能總覽與引導中心。當使用者詢問「整合測試」、「API 測試」、「容器化測試」、「微服務測試」、「測試框架遷移」、「Testcontainers」、「Aspire 測試」等進階測試需求時觸發。會根據具體需求推薦適合的子技能組合，涵蓋整合測試、Testcontainers、Aspire 測試、框架升級等 8 個進階技能。 Make sure to use this skill whenever the user mentions integration testing, API testing, Testcontainers, .NET Aspire testing, WebApplicationFactory, or xUnit/TUnit migration, even if they don't explicitly ask for advanced testing guidance. Keywords: integration testing, 整合測試, API testing, advanced testing, 進階測試, testcontainers, aspire testing, WebApplicationFactory, TestServer, database test, 資料庫測試, EF Core test, MongoDB test, Redis test, Docker test, 容器測試, microservice test, 微服務測試, .NET Aspire, xUnit upgrade, TUnit, framework migration

2026-03-3126

dotnet-testing-advanced-testcontainers-nosql

kevintsengtw/dotnet-testing-agent-skills

Testcontainers NoSQL 整合測試完整指南。當需要對 MongoDB 或 Redis 進行容器化整合測試時使用。涵蓋 MongoDB 文件操作、Redis 五種資料結構、Collection Fixture 模式。包含 BSON 序列化、索引效能測試、資料隔離策略與容器生命週期管理。 Make sure to use this skill whenever the user mentions Testcontainers MongoDB, Testcontainers Redis, NoSQL integration test, BSON serialization, or Redis data structure testing, even if they don't explicitly ask for NoSQL container testing. Keywords: testcontainers mongodb, testcontainers redis, mongodb integration test, redis integration test, nosql testing, MongoDbContainer, RedisContainer, IMongoDatabase, IConnectionMultiplexer, BSON serialization, BsonDocument, 文件模型測試, 快取測試, Collection Fixture

2026-03-3126

dotnet-testing-advanced-tunit-advanced

kevintsengtw/dotnet-testing-agent-skills

TUnit 進階應用完整指南。當需要使用 TUnit 進行資料驅動測試、依賴注入或整合測試時使用。涵蓋 MethodDataSource、ClassDataSource、Matrix Tests、Properties 過濾。包含 Retry/Timeout 控制、WebApplicationFactory 整合、Testcontainers 多服務編排。 Make sure to use this skill whenever the user mentions TUnit advanced, MethodDataSource, ClassDataSource, Matrix Tests, TUnit dependency injection, TUnit Retry/Timeout, or TUnit WebApplicationFactory, even if they don't explicitly ask for TUnit advanced features. Keywords: TUnit advanced, TUnit 進階, MethodDataSource, ClassDataSource, Matrix Tests, MatrixDataSource, MicrosoftDependencyInjectionDataSource, Property, Retry, Timeout, 資料驅動測試, 測試過濾, WebApplicationFactory TUnit, 多容器編排

2026-03-3126

dotnet-testing-advanced-tunit-fundamentals

kevintsengtw/dotnet-testing-agent-skills

TUnit 新世代測試框架入門完整指南。當需要使用 TUnit 建立測試專案或從 xUnit 遷移至 TUnit 時使用。涵蓋 Source Generator 驅動測試發現、AOT 編譯支援、流暢式非同步斷言。包含專案建立、[Test] 屬性、生命週期管理、並行控制與 xUnit 語法對照。 Make sure to use this skill whenever the user mentions TUnit, Source Generator testing, AOT test framework, TUnit vs xUnit, or migrating to TUnit, even if they don't explicitly ask for TUnit fundamentals. Keywords: TUnit, tunit testing, source generator testing, AOT testing, 新世代測試框架, [Test], [Arguments], TUnit.Assertions, Assert.That, Before(Test), After(Test), NotInParallel, TUnit.Templates, Microsoft.Testing.Platform, TUnit vs xUnit, 並行執行

2026-03-3126

المصدر

kevintsengtw

kevintsengtw/dotnet-testing-agent-skills

فتح مستودع GitHub عرض مستودعات المنشئ

أمر التثبيت

تنزيل

تشغيل في Manus

مفيد لـSOC

محللو ضمان جودة البرمجيات والمختبرونمهن الحاسوب والرياضيات15-1253L4

name

dotnet-testing-advanced-testcontainers-database

description

Testcontainers 資料庫整合測試指南

EF Core InMemory 的限制

在選擇測試策略前，必須了解 EF Core InMemory 資料庫的重大限制：

1. 交易行為與資料庫鎖定

不支援資料庫交易 (Transactions)：SaveChanges() 後資料立即儲存，無法進行 Rollback
無資料庫鎖定機制：無法模擬並發 (Concurrency) 情境下的行為

2. LINQ 查詢差異

查詢翻譯差異：某些 LINQ 查詢（複雜 GroupBy、JOIN、自訂函數）在 InMemory 中可執行，但轉換成 SQL 時可能失敗
Case Sensitivity：InMemory 預設不區分大小寫，但真實資料庫依賴校對規則 (Collation)
效能模擬不足：無法模擬真實資料庫的效能瓶頸或索引問題

3. 資料庫特定功能

InMemory 模式無法測試：預存程序、Triggers、Views、外鍵約束、檢查約束、資料類型精確度、Concurrency Tokens 等。

結論：當需要驗證複雜交易邏輯、並發處理、資料庫特定行為時，應使用 Testcontainers 進行整合測試。

Testcontainers 核心概念

Testcontainers 是一個測試函式庫，提供輕量好用的 API 來啟動 Docker 容器，專門用於整合測試。

核心優勢

真實環境測試：使用真實資料庫，測試實際 SQL 語法與資料庫限制
環境一致性：確保測試環境與正式環境使用相同服務版本
清潔測試環境：每個測試有獨立乾淨的環境，容器自動清理
簡化開發環境：開發者只需 Docker，不需安裝各種服務

必要套件

<ItemGroup>
  <!-- 測試框架 -->
  <PackageReference Include="Microsoft.NET.Test.Sdk" Version="18.3.0" />
  <PackageReference Include="xunit" Version="2.9.3" />
  <PackageReference Include="xunit.runner.visualstudio" Version="3.1.5" />
  <PackageReference Include="AwesomeAssertions" Version="9.4.0" />

  <!-- Testcontainers 核心套件 -->
  <PackageReference Include="Testcontainers" Version="4.11.0" />

  <!-- 資料庫容器 -->
  <PackageReference Include="Testcontainers.PostgreSql" Version="4.11.0" />
  <PackageReference Include="Testcontainers.MsSql" Version="4.11.0" />

  <!-- Entity Framework Core -->
  <PackageReference Include="Microsoft.EntityFrameworkCore" Version="9.0.0" />
  <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="9.0.0" />
  <PackageReference Include="Npgsql.EntityFrameworkCore.PostgreSQL" Version="9.0.0" />

  <!-- Dapper (可選) -->
  <PackageReference Include="Dapper" Version="2.1.72" />
  <PackageReference Include="Microsoft.Data.SqlClient" Version="7.0.0" />
</ItemGroup>

重要：使用 Microsoft.Data.SqlClient 而非舊版 System.Data.SqlClient，提供更好的效能與安全性。

環境需求

Windows 10 版本 2004+，啟用 WSL 2，8GB RAM（建議 16GB+），64GB 磁碟空間
Docker Desktop 建議設定：Memory 6GB、CPUs 4 cores、Swap 2GB、Disk 64GB

基本容器操作模式

使用 IAsyncLifetime 管理容器生命週期，在 InitializeAsync 中啟動容器並建立 DbContext，在 DisposeAsync 中釋放資源。支援 PostgreSQL（PostgreSqlBuilder）和 SQL Server（MsSqlBuilder）。

完整程式碼範例請參考 references/container-basics.md

Collection Fixture 模式：容器共享

在大型專案中，每個測試類別都建立新容器會遇到嚴重的效能瓶頸。Collection Fixture 讓所有測試類別共享同一個容器，測試執行時間可減少約 67%。

包含 SQL 腳本外部化策略（將 SQL 檔案從 C# 程式碼分離）與 Wait Strategy 最佳實務。

完整 Collection Fixture 實作、SQL 腳本外部化與 Wait Strategy 範例請參考 references/collection-fixture-and-scripts.md

EF Core 進階功能測試

涵蓋 Include/ThenInclude 多層關聯查詢、AsSplitQuery 避免笛卡兒積、N+1 查詢問題驗證、AsNoTracking 唯讀查詢最佳化等完整測試範例。

完整程式碼範例請參考 references/orm-advanced-testing.md

Dapper 進階功能測試

涵蓋基本 CRUD 測試類別設置、QueryMultiple 一對多關聯處理、DynamicParameters 動態查詢建構等完整測試範例。

完整程式碼範例請參考 references/orm-advanced-testing.md

Repository Pattern 設計原則

介面分離原則 (ISP) 的應用

IProductRepository：基礎 CRUD 操作介面（GetAll、GetById、Add、Update、Delete）
IProductByEFCoreRepository：EF Core 特有進階功能（SplitQuery、BatchUpdate、NoTracking）
IProductByDapperRepository：Dapper 特有進階功能（多表查詢、動態參數、預存程序）

設計優勢

單一職責原則 (SRP)：每個介面專注於特定職責
介面隔離原則 (ISP)：使用者只需依賴所需的介面
依賴反轉原則 (DIP)：高層模組依賴抽象而非具體實作
測試隔離性：可針對特定功能進行精準測試

常見問題處理

Docker 容器啟動失敗

# 檢查連接埠是否被佔用
netstat -an | findstr :5432

# 清理未使用的映像檔
docker system prune -a

ContainerNotRunningException（4.8.0+ 新增）

Testcontainers 4.8.0 起，預設等待策略改為等待容器進入 Running 狀態。若容器未能正常啟動，會拋出此例外。常見原因：映像檔名稱錯誤、Docker 資源不足、連接埠衝突。

記憶體不足問題

調整 Docker Desktop 記憶體配置
限制同時執行的容器數量
使用 Collection Fixture 共享容器

測試資料隔離

在 Dispose 中按照外鍵約束順序清理資料（OrderItems → Orders → Products → Categories）。

輸出格式

產生使用 Testcontainers 的 xUnit 整合測試類別（.cs 檔案）
包含 IAsyncLifetime 容器生命週期管理程式碼
包含 Collection Fixture 共享容器設定
產生外部化 SQL 腳本檔案（.sql）與對應的 .csproj 設定
包含 Repository Pattern 介面與實作範例

參考資源

原始文章

本技能內容提煉自「老派軟體工程師的測試修練 - 30 天挑戰」系列文章：

Day 20 - Testcontainers 初探：使用 Docker 架設測試環境
- 鐵人賽文章：https://ithelp.ithome.com.tw/articles/10376401
- 範例程式碼：https://github.com/kevintsengtw/30Days_in_Testing_Samples/tree/main/day20
Day 21 - Testcontainers 整合測試：MSSQL + EF Core 以及 Dapper 基礎應用
- 鐵人賽文章：https://ithelp.ithome.com.tw/articles/10376524
- 範例程式碼：https://github.com/kevintsengtw/30Days_in_Testing_Samples/tree/main/day21

dotnet-testing-advanced-testcontainers-database

المزيد من هذا المستودع

المزيد من هذا المستودع

Testcontainers 資料庫整合測試指南

EF Core InMemory 的限制

1. 交易行為與資料庫鎖定

2. LINQ 查詢差異

3. 資料庫特定功能

Testcontainers 核心概念

核心優勢

必要套件

環境需求

基本容器操作模式

Collection Fixture 模式：容器共享

EF Core 進階功能測試

Dapper 進階功能測試

Repository Pattern 設計原則

介面分離原則 (ISP) 的應用

設計優勢

常見問題處理

Docker 容器啟動失敗

ContainerNotRunningException（4.8.0+ 新增）

記憶體不足問題

測試資料隔離

輸出格式

參考資源

原始文章

官方文件

相關技能

Testcontainers 資料庫整合測試指南

EF Core InMemory 的限制

1. 交易行為與資料庫鎖定

2. LINQ 查詢差異

3. 資料庫特定功能

Testcontainers 核心概念

核心優勢

必要套件

環境需求

基本容器操作模式

Collection Fixture 模式：容器共享

EF Core 進階功能測試

Dapper 進階功能測試

Repository Pattern 設計原則

介面分離原則 (ISP) 的應用

設計優勢

常見問題處理

Docker 容器啟動失敗

ContainerNotRunningException（4.8.0+ 新增）

記憶體不足問題

測試資料隔離

輸出格式

參考資源

原始文章

官方文件

相關技能