factory-boy 与 model-bakery 对比分析

本文深入剖析了 factory-boy 与 model-bakery 在 Django 5.0+ 环境下的核心差异与实战陷阱：从 factory-boy 因 Django `__init__` 签名变更导致的兼容性问题及 3.3.0+ 版本的优雅修复，到两者在批量数据生成时的性能与语义差异（model-bakery 轻量但忽略默认值与信号，factory-boy 严谨但稍慢），再到中文 Faker 数据配置的常见误区，以及面对 NOT NULL 约束错误时两者的字段补全逻辑差异——尤其强调混合使用易引发隐晦故障，强烈建议项目中统一选型以保障测试稳定性和可维护性。

factory-boy 为什么默认不支持 Django 5.0+ 的 __init__ 签名变更

因为 Django 5.0 开始，Model.__init__ 移除了 **kwargs，只接受显式字段参数；而 factory-boy 旧版（**kwargs 传参，直接抛 TypeError: __init__() got an unexpected keyword argument。

实操建议：

• 升级到 factory-boy>=3.3.0（它已适配新签名，内部改用 model._meta.get_field() 动态构造参数）
• 若卡在旧版本，临时方案是给 Factory 加 class Meta: exclude = ('_state',) 并重写 _create 方法绕过 __init__
• 别手动在 Factory 的 class Meta 里加 model = MyModel 后还塞 __init__ 相关字段——Django 会拒绝接收未声明的字段名

model-bakery 的 make() 在批量创建时比 factory-boy build_batch() 更快？

不是绝对更快，但默认行为更轻量：model-bakery 不走 Django ORM 的完整实例化流程（跳过信号、验证、字段默认值计算），只做最简字段填充；factory-boy 默认调用 build()，会触发 __init__ + 所有字段的 prepare 钩子。

实操建议：

• 如果只是要“能过数据库约束”的裸数据（比如测迁移脚本），baker.make(MyModel, _quantity=100) 确实更快
• 但如果模型有 auto_now_add、default=uuid4 或自定义 save() 逻辑，model-bakery 可能漏掉这些——它不调用 save()，也不保证字段默认值被正确展开
• factory-boy 的 build_batch(100) 虽慢一点，但字段值生成时机可控（比如 Sequence、LazyFunction 都会在每次调用时重新算）

用 factory.Faker 生成中文数据时，为什么 model-bakery 的 make() 总是英文？

因为 model-bakery 默认用 fake 实例来自 faker.providers.en_US，它压根没加载中文 provider；而 factory-boy 的 Faker('zh_CN') 是显式指定语言，且会自动 fallback 到基础字段类型（如 name → name_male → first_name）。

实操建议：

• model-bakery 必须显式配置：from faker import Faker; baker.generators.add('name', lambda: Faker('zh_CN').name())
• 别指望 baker.make(MyModel, name='zh_CN') 这种写法生效——name 是字段名，不是语言标识
• factory-boy 的 Faker('zh_CN', locale='zh_CN') 写法冗余，locale 参数在新版 faker 中已被废弃，只留第一个字符串参数

Django 测试中遇到 IntegrityError: NOT NULL constraint failed 该先查哪个库？

优先查 factory-boy 的 required 字段定义是否遗漏——model-bakery 默认对所有非空字段（blank=False, null=False）自动填假值，而 factory-boy 要求你显式声明或靠 factory.SubFactory 补全外键，否则就崩。

实操建议：

• 开 DEBUG=True 运行测试，看报错里具体是哪个字段失败（比如 NOT NULL constraint failed: myapp_user.profile_id），然后去对应 Factory 查有没有 profile = factory.SubFactory(ProfileFactory)
• model-bakery 对外键字段默认生成关联对象，但如果你写了 baker.make(User, profile=None)，它不会拦截，直接存 NULL 导致崩
• 别在 factory-boy 里用 None 当默认值来“跳过”必填字段——它不会帮你跳，只会原样传给 Django，然后炸

真正麻烦的是混合使用：一个测试里 factory-boy 做主模型，model-bakery 做关联模型，结果字段生成策略不一致，错误堆栈还藏得深。这种时候，宁可统一换掉一个，也别硬凑。

今天关于《factory-boy 与 model-bakery 对比分析》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！