# Testcontainers NoSQL 集成测试指南 ## 适用于当被要求执行以下任务时，请使用此技能： * 使用 Testcontainers 测试 MongoDB 文件操作 * 使用 Testcontainers 测试 Redis 快取服务 * 创建 MongoDB Collection Fixture 共享容器 * 创建Redis Collection Fixture 共享容器 * 测试 MongoDB BSON 序列化与复杂文件结构 * 测试 MongoDB 指标符合与唯一性约束 * 测试Redis五种数据结构（String、Hash、List、Set、Sorted Set） * 实作NoSQL资料库的数据隔离策略 ## 核心概念 ### NoSQL 测试的挑战 NoSQL数据库测试与关联式数据库有显着差异： 1. **文件模型复杂度** ：MongoDB支持巢结构件、阵列、字典等复杂结构 2. **无固定Schema**：需要跨越测试验证数据结构的一致性 3. **虚拟数据结构** ：Redis有五种主要数据结构，各有不同的使用场景 4. **序列化处理**：BSON (MongoDB) 与 JSON (Redis) 序列化行为需要验证 ### 测试容器的优势 * **真实环境模拟**：使用实际的 MongoDB 7.0 和 Redis 7.2 容器 * **一致性测试** ：测试结果直接反映正式环境行为 * **隔离性保证**：每个测试环境完全独立 * **满足验证** ：可进行真实的指标满足测试 ## 环境需求 ### 必要套件 <项目Sdk =“Microsoft.NET.Sdk”> <属性组> net9.0 <可空>启用启用假 <项目组> ### 套件版本说明套件 | 版本 | 用途 ---|---|--- MongoDB. 驱动程序 | 3.0.0 | MongoDB官方驱动程序，支持最新功能 MongoDB.Bson | 3.0.0 | BSON序列化处理 StackExchange.Redis | 2.8.16 | Redis客户端，支持Redis 7.x 测试容器.MongoDb | 4.0.0 | MongoDB 容器管理测试容器.Redis | 4.0.0 | Redis容器管理 ** ** ## MongoDB容器化测试内容涵盖 MongoDB Container Fixture 建立、复杂文件模型设计（巢结构件、数组、字典）、BSON 序列化测试、CRUD 操作测试（含乐观锁定）以及索引结果与唯一性约束测试。使用 Collection Fixture 模式共享容器，节省 80% 以上的测试时间。 > 📖 完整码示例请参考 [MongoDB 容器化测试详细指南]() ** ** ## Redis容器化测试涵盖Redis容器夹具建立、快取模型设计（CacheItem泛型包装器、UserSession、RecentView、LeaderboardEntry）以及Redis五种数据结构（String、Hash、List、Set、Sorted Set）的完整测试范例，包含TTL过渡测试与数据隔离策略。 > 📖 完整码示例请参考 [Redis 容器化测试详细指南]() ** ** ## 最佳实践 ### 1\.采集夹具模式使用 Collection Fixture 共享容器，避免每个测试重启容器： // 定义集合 [CollectionDefinition("MongoDb 集合")] 公共类 MongoDbCollectionFixture : ICollectionFixture { } // 使用集合 [集合(“MongoDb集合”)] 公共类 MyMongoTests { 公共MyMongoTests（MongoDbContainerFixture固定装置） { // 使用共享的容器 } } ### 2\. 数据隔离策略保证测试间不互相干扰： // MongoDB：使用唯一的电子邮件/用户名 var user = 新的用户文档 { 用户名 = $"testuser_{Guid.NewGuid():N}", 电子邮件 = $"test_{Guid.NewGuid():N}@example.com" }; // Redis：使用唯一的出口密钥 var testId = Guid.NewGuid().ToString("N")[..8]; var key = $"test:{testId}:mykey"; ### 3\. 清理策略 // MongoDB：测试后清理等待固定装置.ClearDatabaseAsync(); // Redis：使用KeyDelete和FLUSHDB（避免权限问题） var key = server.Keys(database.Database); if (keys.Any()) { 等待数据库.KeyDeleteAsync(keys.ToArray()); } ### 4\. 实际考量策略| 说明 ---|--- 收藏夹具| 容器只启动一次，节省80%+时间资料隔离 | 使用唯一密钥/ID而非清空资料库批量操作 | 使用InsertManyAsync、SetMultipleStringAsync 指数建立| 在夹具初始化时建立索引 ** ** ## 常见问题 ### Redis FLUSHDB权限问题某些 Redis 容器图像档默认未启用 admin 模式： // ❌ 错误：可能失败等待服务器.FlushDatabaseAsync(); // ✅ 正确：使用 KeyDelete var key = server.Keys(database.Database); if (keys.Any()) { 等待数据库.KeyDeleteAsync(keys.ToArray()); } ### MongoDB 唯一索引重复插入 // 测试时使用唯一的电子邮件避免冲突 var uniqueEmail = $"test_{Guid.NewGuid():N}@example.com"; ### 容器启动超时 // 增加等待时间 _container = 新 MongoDbBuilder() .WithImage("mongo:7.0") .WithWaitStrategy(Wait.ForUnixContainer() .直到端口可用(27017)) .Build(); ** ** ## 相关技能 * [testcontainers-database]() \- PostgreSQL/MSSQL容器化测试 * [aspnet-integration-testing]() \- ASP.NET Core 集成测试 * [nsubstitute-mocking]() \- 测试替身与 Mock ** ** ## 参考资源 ### 原始文章本技能内容提炼自「老派软体工程师的测试修练 - 30天挑战」系列文章： * **Day 22 - Testcontainers 集成测试：MongoDB 及 Redis 基础到进阶** * 铁人赛文章： * 示例程序代码： ### 官方文件 * [Testcontainers官方网站]() * [.NET Testcontainers 文件]() * [MongoDB.Driver 官方文件]() * [StackExchange.Redis 官方文件]() * [xUnit 集合装置]()

Dotnet 测试 高级测试容器 Nosql

包含技能

Dotnet 测试高级测试容器 Nosql