如何正确使用 Factory Boy 在 Django 中创建模型实例-Python教程-PHP中文网

本文详解 factory boy 在 django 项目中因模块导入错误导致“module object is not callable”或“no attribute 'create'”问题的根本原因与标准解决方案，重点强调工厂类定义与导入路径的匹配规范。

本文详解 factory boy 在 django 项目中因模块导入错误导致“module object is not callable”或“no attribute 'create'”问题的根本原因与标准解决方案，重点强调工厂类定义与导入路径的匹配规范。

在 Django 项目中使用 Factory Boy 创建测试数据时，一个常见却极易被忽视的问题是：工厂类无法被正确调用，表现为 TypeError: 'module' object is not callable 或 AttributeError: module ... has no attribute 'create'。这并非 Factory Boy 配置错误，而是 Python 模块导入方式不当所致。

? 根本原因：文件名与类名冲突导致导入歧义

当你的工厂定义位于 webshare/tests/factories.py 文件中，且该文件内定义了名为 WebShareFileFactoryBoy 的类时，若采用如下错误导入方式：

from webshare.tests.factories import WebShareFileFactoryBoy  # ❌ 错误！

Python 会将 factories.py 视为一个模块（module），而 WebShareFileFactoryBoy 实际是该模块内的一个类。但若 factories.py 文件本身未被正确解析为包（例如缺少 __init__.py），或 IDE/解释器因缓存误判，就可能将 WebShareFileFactoryBoy 解析为模块对象而非类——从而触发 'module' object is not callable 错误。

更隐蔽的情况是：当你执行 from webshare.tests.factories.WebShareFileFactoryBoy import WebShareFileFactoryBoy（即把类名当作子包名）——这仅在目录结构为 factories/WebShareFileFactoryBoy.py 时才合法，而你的实际结构是单文件 factories.py，因此该导入本质是侥幸生效的路径误用，不具备可维护性与可移植性。

Django

避免常见的 Django 错误——QuerySet 评估、N+1 查询、迁移冲突和 ORM 陷阱。

下载

✅ 正确做法：规范命名 + 显式导入类

确保工厂模块可被识别为包：在 webshare/tests/ 及其子目录（如 factories/）下放置空的 __init__.py 文件；
推荐命名分离：将工厂类定义文件命名为 factories.py，但避免与类名同名（如不建议建 WebShareFileFactoryBoy.py）；
使用标准显式导入语法：

# ✅ 正确导入方式（假设工厂类定义在 webshare/tests/factories.py 中）
from webshare.tests.factories import WebShareFileFactoryBoy

# 创建实例（注意：调用 .create()，不是直接调用类）
instance = WebShareFileFactoryBoy.create()

# 或生成但不保存到数据库（内存对象）
instance_stub = WebShareFileFactoryBoy.build()

工厂类定义需完整且兼容最新版本（Factory Boy ≥ 3.0）：

# webshare/tests/factories.py
import factory
from webshare.models import WebShareFileFolders


class WebShareFileFactoryBoy(factory.django.DjangoModelFactory):
    class Meta:
        model = WebShareFileFolders
        # DjangoModelFactory 默认支持 create()/build()，无需额外声明

    inode = factory.Sequence(lambda n: n)
    name = factory.Faker('name')
    path = factory.Faker('text', max_nb_chars=50)
    is_dir = factory.Faker('boolean')

⚠️ 注意：factory.Faker('boolean') 在较新 Faker 版本中已弃用，建议改用 factory.Faker('pybool') 以确保兼容性。

? 验证是否成功

进入 Django shell 后逐行验证：

$ python manage.py shell

>>> from webshare.tests.factories import WebShareFileFactoryBoy
>>> instance = WebShareFileFactoryBoy.create()  # ✅ 应成功创建并保存至 DB
>>> print(instance.name, instance.is_dir)
John Doe True
>>> isinstance(instance, WebShareFileFolders)
True