# TUnit进阶应用：数据驱动测试、依赖注入与整合测试实战 ## 适用于本技能讲述 TUnit 进阶应用技巧，从数据驱动测试到依赖注入，从执行控制到 ASP.NET Core 集成测试实战。 **核心主题：** * 资料驱动测试进阶技巧（MethodDataSource、ClassDataSource、Matrix Tests） * Properties 属性标记与测试过滤 * 测试生命周期与依赖注入 * 执行控制（重试、超时、DisplayName） * ASP.NET Core集成测试（WebApplicationFactory） * 性能测试与负载率测试 * TUnit + Testcontainers 复杂基础设施编排 * TUnit 引擎模式与疑难排解 ** ** ## 资料驱动测试进阶技巧 TUnit 提供 MethodDataSource、ClassDataSource、Matrix Tests 清晰进阶数据源。MethodDataSource 最灵活，支持动态产生与外部文件加载；ClassDataSource 适合跨测试类别共享数据与 AutoFixture 集成；Matrix Tests 自动产生所有参数组合（注意控制数量避免爆炸性增长）。 > 📖 完整示例与比较表请参阅 [references/data-driven-testing.md]() ** ** ## Properties 属性标记与测试过滤 ### 基本属性使用 [测试] [属性（“类别”，“数据库”）] [属性（“优先级”，“高”）] 公共异步任务数据库测试_高优先级_应能渗透属性过滤() { 等待 Assert.That(true).IsTrue(); } [测试] [属性（“类别”，“单位”）] [属性（“优先”，“中”）] public async Task UnitTest_中等优先级_基本验证() { 等待 Assert.That(1 + 1).IsEqualTo(2); } [测试] [属性（“类别”，“集成”）] [属性（“优先级”，“低”）] [物业（“环境”，“发展”）] public async Task IntegrationTest_低优先级_仅开发环境执行() { 等待 Assert.That("Hello World").Contains("World"); } ### 建立一致的属性命名规范公共静态类 TestProperties { // 测试类别公共常量字符串CATEGORY_UNIT =“单位”; public const string CATEGORY_INTEGRATION = "集成"; 公共常量字符串CATEGORY_E2E =“E2E”; // 优先级公共常量字符串 PRIORITY_CRITICAL = "关键"; 公共 const string PRIORITY_HIGH = "高"; 公共 const string PRIORITY_MEDIUM = "中"; 公共常量字符串 PRIORITY_LOW = "低"; // 环境 public const string ENV_DEVELOPMENT = "开发"; 公共 const string ENV_STAGING = "暂存"; 公共 const string ENV_Production = "生产"; } [测试] [属性（“类别”，TestProperties.CATEGORY_UNIT）] [属性（“优先级”，TestProperties.PRIORITY_HIGH）] 公共异步任务示例测试_使用一致性_确保一致性() { 等待 Assert.That(1 + 1).IsEqualTo(2); } ### TUnit 测试过滤执行 TUnit 使用 `dotnet run` 而不是 `dotnet test`： # 只执行单元测试 dotnet run --treenode-filter "/*/*/*/*[类别=单位]" # 只执行高优先测试级 dotnet run --treenode-filter "/*/*/*/*[优先级=高]" # 组合条件：执行高优先级的单元测试 dotnet run --treenode-filter "/*/*/*/*[(类别=单位)&(优先级=高)]" # 或条件：执行单元测试或冒烟测试 dotnet run --treenode-filter "/*/*/*/*[(类别=单位)|(套件=烟雾)]" # 执行特定功能的测试 dotnet run --treenode-filter "/*/*/*/*[Feature=OrderProcessing]" **过滤语法注意事项：** * 路径模式 `/*/*/*/*` 代表 Assembly/Namespace/Class/Method 体系 * 属性名称大小写敏感 * 组合条件必须用括号正确包围 ** ** ## 测试生命周期管理 TUnit 提供完整的生命周期钩子：`[Before(Class)]` → `[Before(Test)]` → 测试方法 → `[After(Test)]` → Dispose → `[After(Class)]`。还有 Assembly/TestSession 体系与 `[BeforeEvery]`/`[AfterEvery]` 全域钩子。目前式永远先执行，BeforeClass/AfterClass 各只执行一次。 > 📖 完整属性家族与示例请参阅 [references/lifecycle-management.md]() ** ** ## 依赖注入模式 ### TUnit 依赖注入核心概念 TUnit 的注入电流位于数据源生成器基础上：公共类 MicrosoftDependencyInjectionDataSourceAttribute ： DependencyInjectionDataSourceAttribute { 私有静态只读 IServiceProvider ServiceProvider = CreateSharedServiceProvider(); 公共覆盖 IServiceScope CreateScope(DataGeneratorMetadata dataGeneratorMetadata) { 返回 ServiceProvider.CreateScope(); } 公共覆盖对象？创建（IServiceScope范围，类型类型） { 返回范围.ServiceProvider.GetService(type); } 私有静态 IServiceProvider CreateSharedServiceProvider() { 返回新的ServiceCollection() .AddSingleton() .AddSingleton() .AddSingleton() .AddSingleton, MockLogger>() .AddTransient() .BuildServiceProvider(); } } ### 使用 TUnit 依赖注入 [微软依赖注入数据源] 公共类 DependencyInjectionTests(OrderService orderService) { [测试] 公共异步任务CreateOrder_使用TUnit依赖注入_应正确运作() { // 安排 - 依赖已经依赖 TUnit DI 自动注入 var items = new List { new() { ProductId = "PROD001", ProductName = "测试商品", 单价 = 100m, 数量 = 2 } }; // 行动 var order = wait orderService.CreateOrderAsync("CUST001", CustomerLevel.VIP会员, items); // 断言等待 Assert.That(order).IsNotNull(); 等待 Assert.That(order.CustomerId).IsEqualTo("CUST001"); wait Assert.That(order.CustomerLevel).IsEqualTo(CustomerLevel.VIP会员); } [测试] 公共异步任务TUnitDependencyInjection_验证自动注入_服务应为正确类型() { 等待 Assert.That(orderService).IsNotNull(); 等待 Assert.That(orderService.GetType().Name).IsEqualTo("OrderService"); } } ### TUnit DI 与手动依赖建立比较特性 | TUnit DI | 手动依赖建立 ---|---|--- **设定复杂度** | 一次设定，重复使用 | 每个测试都需要手动设置 **可维护性** | 依赖变更只需修改一个地方 | 需要修改所有使用的测试 **一致性** | 与产品方案码的 DI 一致 | 可能与实际应用计划不一致 **测试强制性** | 于注意力测试逻辑| 被依赖建立计划码干扰 **范围管理** | 自动管理服务范围 | 需要手动管理物品生命周期 **错误风险** | 框架保证依赖正确投入| 可能遗漏或错误建立某些依赖 ** ** ## 执行控制与测试质量 * **`[Retry(n)]`** ：仅用于外部依赖造成的不稳定测试（网路、档案锁定），不适用于逻辑错误 * **`[Timeout(ms)]`** ：为完成敏感测试设定合理限度，配置 `Stopwatch` 验证 SLA * **`[DisplayName]`** ：支持`{0}`参数插值，让测试报告更贴近业务语言 > 📖 完整示例（重试/超时/显示名称）请参阅 [references/execution-control.md]() ** ** ## ASP.NET Core 集成测试在 TUnit 中使用 `WebApplicationFactory` 进行 ASP.NET Core 集成测试，横跨实作 `IDisposable` 管理生命周期。内容 API 响应验证、Content-Type 标头检查，以及均基准与关心负载测试。 > 📖 完整的 WebApplicationFactory 集成与负载测试示例请参阅 [references/aspnet-integration.md]() ** ** ## TUnit + Testcontainers 基础设施编排使用 `[Before(Assembly)]` / `[After(Assembly)]` 在 Assembly 系统管理 PostgreSQL、Redis、Kafka 等多容器编排中，搭配 `NetworkBuilder` 消耗建立网路。容器只需启动一次，大幅减少启动时间与资源消耗，同时保持测试间的数据隔离。 > 📖 完整容器编排与全域共享示例请参阅 [references/tunit-testcontainers.md]() ** ** ## TUnit 引擎模式 ### 源码生成模式（默认模式） ████████╗██╗ ██╗███╗ ██╗██╗████████╗ ╚══██╔══╝██║██║████╗██║██║╚══██╔══╝ ██║ ██║ ██║██╔██╗ ██║██║ ██║ ██║ ██║ ██║██║╚██╗██║██║ ██║ ██║╚██████╔╝██║╚████║██║██║ ╚═╝╚═════╝╚═╝╚═══╝╚═╝╚═╝ 引擎模式：源生成 **特色与优势：** * **编译期产生** ：所有测试发现逻辑在编译时产生，不需要执行时引用 * **表现优异** ：比反射模式快数倍 * **型别安全** ：编译期间验证测试配置和资料来源 * **AOT相容** ：支持Native AOT完全编译 ### 反射模式（反射模式） # 启用引用模式 dotnet run -- --reflection # 或设置环境变量 $env:TUNIT_EXECUTION_MODE = "反射" 点网运行 **适用场景：** * 动态测试发现 * F# 和 VB.NET 专案（自动使用） * 某些依赖引用的测试模式 ### 原生 AOT 支持 <属性组> true dotnet 发布 -c 发布 ** ** ## 常见问题与疑难排解 ### 测试统计显示异常问题 **问题现象：** `测试摘要：总计: 0, 失败: 0, 成功: 0` **解决步骤：** 1. **确保专案档设定正确：** <属性组> true 2. **确保 GlobalUsings.cs 正确：** 全球使用系统；全局使用 System.Collections.Generic；全局使用 System.Linq；全局使用 System.Threading.Tasks；全局使用 TUnit.Core；全局使用 TUnit.Assertions；全局使用 TUnit.Assertions.Extensions； 3. **集成测试的特殊设置：** // 在 WebApi 专案的 Program.cs 最后加上 publicpartialclassProgram{} //让集成测试可以访问 4. **清理和重建：** 点网干净；点网构建 dotnet 测试 -- 详细程度正常 ### 源生成器相关问题 **问题：测试类别无法发现** * **解决** ：确保专案完全重建 (`dotnet clean; dotnet build`) **问题：编译时出现疑问错误** * **解决** ：检查是否有其他 Source Generator 套件，考虑更新到相容版本 ### 诊断选项 # .editorconfig tunit.enable_verbose_diagnostics = true <属性组> true ** ** ## 实务建议 ### 数据驱动测试的选择策略 * **MethodDataSource** ：适合动态数据、复杂对象、外部文件加载 * **ClassDataSource** ：适合共享数据、AutoFixture集成、跨测试类别重用 * **矩阵测试** ：适合组合测试，但要注意参数数量避免爆炸性增长 ### 执行最佳控制实践 * **重试** ：只用于真正不稳定的外部依赖测试 * **Timeout** ：为满足敏感的测试限制设定合理 * **DisplayName** ：让测试报告更符合业务语言 ### 整合测试策略 * 使用WebApplicationFactory进行完整的Web API测试 *运用TUnit + Testcontainers建立复杂的多服务测试环境 * 属性渗透注入系统管理复杂度的依赖关系 * 只测试实际存在的功能，避免测试不存在的端点 ** ** ## 范本档案档案名称 | 说明 ---|--- [data-source-examples.cs]() | MethodDataSource、ClassDataSource 示例 [matrix-tests-examples.cs]() |矩阵测试组合测试示例 [lifecycle-di-examples.cs]() | 生命周期管理与依赖注入范例 [execution-control-examples.cs]() |重试、超时、显示名称示例 [aspnet-integration-tests.cs]() | ASP.NET Core 集成测试示例 [testcontainers-examples.cs]() | Testcontainers 基础设施编排示例 ** ** ## 参考资源 ### 原始文章本技能内容提炼自「老派软体工程师的测试修练 - 30天挑战」系列文章： * **第29天 - TUnit进阶应用：数据驱动测试与依赖注入深度实战** * 铁人赛文章： * 示例程序代码： * **第 30 天 - TUnit 进阶应用 - 执行控制与测试质量和 ASP.NET Core 集成测试实战** * 铁人赛文章： * 示例程序代码： ### TUnit 官方资源 * [TUnit 官方网站]() * [TUnit GitHub 存储库]() ### 进阶功能文件 * [TUnit 方法数据源文件]() * [TUnit 类数据源文件]() * [TUnit 矩阵测试文件]() * [TUnit 属性文件]() * [TUnit 依赖注入文件]() * [TUnit 重试文件]() * [TUnit 超时文件]() * [TUnit 引擎模式文件]() * [TUnit ASP.NET Core 文件]() * [TUnit 复杂测试基础设施]() ### 测试容器相关资源 * [Testcontainers.NET 官方网站]() * [Testcontainers.NET GitHub]()

Dotnet 测试高级 Tunit 高级

包含技能