# AutoFixture 与 Bogus 整合应用指南 ## 适用于当被要求执行以下任务时，请使用此技能： * 整合 AutoFixture 与 Bogus 两套工具 * 建立混合测试资料产生器 * 设计 ISpecimenBuilder 整合虚假数据产生 * 创建自订 AutoData 属性使用 Bogus * 处理循环参考问题 * 建立统一的测试数据工厂 * 设计测试类别整合资料产生功能 ** ** ## 核心概念 ###为什么需要整合？ **自动夹具的优势**： * 快速产生匿名测试资料 * 复杂工件结构的自动处理 * 良好的循环参考处理机制 **虚假的优势**： *产生真实感的语意化数据 * 丰富的资料类型支持（Email、电话、地址等） * 对比验证的数据格式 **整合后的效果**： // 整合之前的问题 var user = Fixture.Create<用户>(); // user.Email 可能是 "Email1a2b3c4d"，而不是真实的 Email // 整合后 var user = IntegratedFixture.Create(); // user.Email 是“john.doe@example.com” // user.FirstName 是“约翰” // 其他属性由 AutoFixture 自动填充 ** ** ## 套件安装 ** ** ## 整合架构 ### 整合方式总览整合方式 | 适用场景 | 复杂度 ---|---|--- 属性系统 SpecimenBuilder | 属性特定使用 Bogus | 低类型体系 SpecimenBuilder | 整个类型使用Bogus | 中混合发电机| 混合发电机统一API整合| 中整合工厂(IntegratedFactory) | 完整测试场景 | 高自动修改 AutoData 属性 | xUnit 整合 | 低 ** ** ## 核心整合技术通过 `ISpecimenBuilder` 介面实现属性体系与类型体系的整合，补充补充方法（`WithBogus()`、`WithOmitOnRecursion()`、`WithSeed()`）简化设定流程。主题电子邮件、电话、姓名、地址等常用 SpecimenBuilder 以及完整的类型产生器注册模式。 > 📖 完整内容请参阅 [references/core-integration-techniques.md]() ** ** ## 循环参考处理 ###为什么循环参考很重要？公开课用户 { 上市公司？公司{得到;放; } // 用户参考公司 } 公开课公司 { 公共列表<用户>员工{获取;放; } = 新的(); // 公司参考用户 } **问题** ：用户→公司→员工（用户）→公司→...无限循环 ### 解决方案：OmitOnRecursionBehavior var 固定装置 = 新固定装置(); Fixture.Behaviors.OfType() .ToList() .ForEach(b => 固定装置.Behaviors.Remove(b)); Fixture.Behaviors.Add(new OmitOnRecursionBehavior()); **效果**： * ✅ 避免 StackOverflowException * ✅ 循环参考的属性设为 null 或空集合 * ⚠️某些核心属性可能为空（这是预期行为） ** ** ## 自订 AutoData 属性 ### 伪造的自动数据属性公共类BogusAutoDataAttribute：AutoDataAttribute { 公共BogusAutoDataAttribute（）：base(() => new Fixture().WithBogus()) { } } ### 使用方式 [理论] [伪造的汽车数据] public void 使用集成数据测试(User用户，Address地址) { user.Email.Should().Contain("@"); user.FirstName.Should().NotBeNullOrEmpty(); 地址.City.Should().NotBeNullOrEmpty(); } ** ** ## 混合产生器 ### ITestDataGenerator 介面公共接口 ITestDataGenerator { T 生成(); IEnumerable 生成(int count); T 生成(操作配置); } ### HybridTestDataGenerator 实作公共类 HybridTestDataGenerator ：ITestDataGenerator { 私有只读 IFixture _fixture；公共 HybridTestDataGenerator(int?seed = null) { _fixture = 新夹具() .WithBogus() .WithOmitOnRecursion(); if (seed.HasValue) { Bogus.Randomizer.Seed = new Random(seed.Value); } } 公共 T 生成() => _fixture.Create(); 公共 IEnumerable 生成 (int count) => Enumerable.Range(0, count).Select(_ => 生成()); 公共 T 生成（操作配置） { var item = 生成(); 配置（项目）；退货； } } ** ** ## 整合测试数据工厂 ### 集成测试数据工厂公共类 IntegratedTestDataFactory { 私有只读 IFixture _fixture；私有只读字典<类型，对象> _cache = new(); 公共 IntegratedTestDataFactory(int?seed = null) { _fixture = 新夹具() .WithBogus() .WithOmitOnRecursion() .WithRepeatCount(3); if (seed.HasValue) { _fixture.WithSeed(seed.Value); } } 公共 T CreateFresh() => _fixture.Create(); 公共列表 CreateMany (int count = 3) => _fixture.CreateMany(count).ToList(); 公共 T GetCached() 其中 T ：类 { var 类型 = typeof(T); if (_cache.TryGetValue(type, out var 已缓存)) 返回（T）缓存； var 实例 = CreateFresh(); _cache[类型] = 实例；返回实例； } 公共无效ClearCache() => _cache.Clear(); /// <摘要> /// 建立完整的测试场景 /// 公共测试场景 CreateTestScenario() { var company = CreateFresh<公司>(); var users = CreateMany<用户>(5); var order = CreateMany(10); // 建立关联 foreach（用户中的var用户） { 用户.公司=公司； } 公司.员工=用户；返回新的测试场景 { 公司=公司，用户=用户，订单=订单 }; } } ** ** ## 测试类别 ### TestBase实作公共抽象类 TestBase { 受保护的只读 IFixture 夹具； protected readonly HybridTestDataGenerator 生成器；受保护的只读 IntegratedTestDataFactory 工厂；受保护的 TestBase(int?seed = null) { 夹具 = 新夹具() .WithBogus() .WithOmitOnRecursion() .WithRepeatCount(3); if (seed.HasValue) { Fixture.WithSeed(seed.Value); } 生成器 = 新的 HybridTestDataGenerator(种子); 工厂=新的IntegratedTestDataFactory（种子）； } protected T Create() => Fixture.Create(); 受保护的列表 CreateMany (int count = 3) => Fixture.CreateMany(count).ToList(); protected T 创建（操作配置） { var 实例 = Create(); 配置（实例）；返回实例； } } ** ** ## 种子管理与可重置性 ### 重要限制由于AutoFixture和Bogus有不同的随机数管理机制： * ✅ 种子保证测试行为稳定性 * ✅ 种子预定数据格式一致性 * ❌无法保证所有属性值一 ###建议做法 // 使用种子保证稳定性 var 工厂 = 新 IntegratedTestDataFactory(种子: 12345); // 如果需要完全可重置，使用单一工具 var faker = new Faker(); faker.UseSeed(12345); ** ** ## 使用示例 ### 基本整合使用 [事实] public void AutoFixture_整合_Bogus_应能产生真实感测数据() { // 排列 var Fixture = new Fixture().WithBogus(); // 行动 var user = Fixture.Create<用户>(); // 断言 user.Email.Should().Contain("@"); user.FirstName.Should().NotBeNullOrEmpty(); user.Phone.Should().MatchRegex(@"[\d\-\(\)\s]+"); } ### 使用工厂建立测试场景 [事实] public void _应能建立完整的测试场景() { // 排列 var 工厂 = 新的 IntegratedTestDataFactory(种子: 42); // 行动 var 场景=factory.CreateTestScenario(); // 断言 scene.Company.Should().NotBeNull(); 场景.Users.Should().HaveCount(5); 场景.Orders.Should().HaveCount(10); scene.Users.Should().AllSatisfy(用户 => { user.Company.Should().Be(scenario.Company); user.Email.Should().Contain("@"); }); } ** ** ## 最佳实践 ###建议做法 1. **永远先处理循环参考** Fixture.WithOmitOnRecursion().WithBogus(); 2. **为常用实体建立专用SpecimenBuilder** 3. **使用种子保证测试稳定性** 4. **建立测试类别统一数据产生逻辑** 5. **适当使用快取提升即可** ### 避免事项 1. ❌过度设计，保持简单实用 2. ❌期望的整合环境完全可替代 3. ❌忽略循环参考处理 4. ❌在每个测试中重新建立Fixture ** ** ## 集成与 AutoFixture/Bogus 的比较致 | 纯汽车夹具 | 纯假| 整合方案 ---|---|---|--- 资料真实感 | 低| 高| 高设定复杂度| 低| 中文 | 中对象关联处理 | 自动 | 手动 | 自动循环参考处理 | 内建 | 无 | 整合可重置性 | 高| 高| 中适用场景 | 单元 |测试整合/测试原型 | 二者皆可 ** ** ## 参考资源 ### 原始文章本技能内容提炼自「老派软体工程师的测试修练 - 30天挑战」系列文章： * **第 15 天 - AutoFixture 与 Bogus 整合：结合两者优势** * 铁人赛文章： * 示例程序代码： ### 官方文件 * [AutoFixture GitHub]() * [伪造的 GitHub 存储库]() ** ** ## 相关技能 * [autofixture-basics]() \- AutoFixture 基础使用 * [autofixture-customization]() \- AutoFixture 自订化策略 * [autodata-xunit-integration]() \- AutoData 属性集成 * [bogus-fake-data]() \- Bogus 假资料产生器

Dotnet 测试 Autofixture 虚假集成

包含技能