Testcontainers NoSQL 整合測試指南

套件版本說明

MongoDB 容器化測試

涵蓋 MongoDB Container Fixture 建立、複雜文件模型設計（巢狀物件、陣列、字典）、BSON 序列化測試、CRUD 操作測試（含樂觀鎖定）以及索引效能與唯一性約束測試。使用 Collection Fixture 模式共享容器，節省 80% 以上的測試時間。

完整程式碼範例請參考 MongoDB 容器化測試詳細指南

Redis 容器化測試

涵蓋 Redis Container Fixture 建立、快取模型設計（CacheItem 泛型包裝器、UserSession、RecentView、LeaderboardEntry）以及 Redis 五種資料結構（String、Hash、List、Set、Sorted Set）的完整測試範例，包含 TTL 過期測試與資料隔離策略。

完整程式碼範例請參考 Redis 容器化測試詳細指南

最佳實踐

1. Collection Fixture 模式

使用 Collection Fixture 共享容器，避免每個測試重啟容器：

// 定義集合
[CollectionDefinition("MongoDb Collection")]
public class MongoDbCollectionFixture : ICollectionFixture<MongoDbContainerFixture> { }

// 使用集合
[Collection("MongoDb Collection")]
public class MyMongoTests
{
    public MyMongoTests(MongoDbContainerFixture fixture)
    {
        // 使用共享的容器
    }
}

2. 資料隔離策略

確保測試間不互相干擾：

// MongoDB：使用唯一的 Email/Username
var user = new UserDocument
{
    Username = $"testuser_{Guid.NewGuid():N}",
    Email = $"test_{Guid.NewGuid():N}@example.com"
};

// Redis：使用唯一的 Key 前綴
var testId = Guid.NewGuid().ToString("N")[..8];
var key = $"test:{testId}:mykey";

3. 清理策略

// MongoDB：測試後清理
await fixture.ClearDatabaseAsync();

// Redis：使用 KeyDelete 而非 FLUSHDB（避免權限問題）
var keys = server.Keys(database.Database);
if (keys.Any())
{
    await database.KeyDeleteAsync(keys.ToArray());
}

4. 效能考量

常見問題

Redis FLUSHDB 權限問題

某些 Redis 容器映像檔預設不啟用 admin 模式：

// ❌ 錯誤：可能失敗
await server.FlushDatabaseAsync();

// ✅ 正確：使用 KeyDelete
var keys = server.Keys(database.Database);
if (keys.Any())
{
    await database.KeyDeleteAsync(keys.ToArray());
}

MongoDB 唯一索引重複插入

// 測試時使用唯一的 Email 避免衝突
var uniqueEmail = $"test_{Guid.NewGuid():N}@example.com";

容器啟動超時

// 增加等待時間
_container = new MongoDbBuilder()
    .WithImage("mongo:7.0")
    .WithWaitStrategy(Wait.ForUnixContainer()
        .UntilCommandIsCompleted("mongosh --eval 'db.runCommand({ ping: 1 })'"))
    .Build();

相關技能

• testcontainers-database - PostgreSQL/MSSQL 容器化測試
• aspnet-integration-testing - ASP.NET Core 整合測試
• nsubstitute-mocking - 測試替身與 Mock
• xunit-upgrade-guide - xUnit v3 升級指南（含 Testcontainers.XunitV3 整合）

輸出格式

• 產生 Container Fixture 類別（MongoDB/Redis 容器管理）
• 產生測試類別含 Collection Fixture 設定
• 提供 .csproj 套件參考配置
• 包含資料隔離與容器生命週期管理程式碼

參考資源

原始文章

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

• Day 22 - Testcontainers 整合測試：MongoDB 及 Redis 基礎到進階
  • 鐵人賽文章：https://ithelp.ithome.com.tw/articles/10376740
  • 範例程式碼：https://github.com/kevintsengtw/30Days_in_Testing_Samples/tree/main/day22

官方文件

• Testcontainers 官方網站
• .NET Testcontainers 文件
• MongoDB.Driver 官方文件
• StackExchange.Redis 官方文件
• xUnit Collection Fixtures