Django项目中pytest无法检测独立文件夹fixtures问题咨询

你遇到的fixture无法识别问题，核心来自两个配置错误：

1. 初始配置的导入路径写错：你的fixtures目录和apps目录是项目根目录下的同级项，配置pytest_plugins = ["apps.fixtures"]会让Python去apps文件夹下找fixtures包，路径完全不匹配，自然导入失败。
2. 即便路径写对，仅填写包名也无法加载拆分在子文件中的fixture：pytest加载插件时不会自动递归扫描包下的所有子模块，只会加载你显式指定的单个模块，或是模块中对外暴露的对象。

以下方案任选其一即可，优先推荐改动最小的方案1。

方案1：修正conftest.py的插件注册配置（无需调整现有目录结构） #

保留你项目根目录下的conftest.py，在pytest_plugins列表中显式列出每一个存放fixture的子模块完整路径，不要只写包名：

# 项目根目录 conftest.py
pytest_plugins = [
    "fixtures.core",
    "fixtures.users",
]

如果你之前已经把fixtures目录移动到了apps目录下，只需要把路径对应调整为"apps.fixtures.core"、"apps.fixtures.users"即可。
需要提前确认两个前置条件：

• fixtures目录下必须存在__init__.py文件（你已配置，这步无问题）
• 运行pytest时的工作目录为项目根目录，若使用pytest-django，需确认pytest.ini/pyproject.toml中的DJANGO_SETTINGS_MODULE配置正确，保证Python可以正常导入项目模块。

方案2：在fixtures包的初始化文件中统一导出fixture #

如果你不想每次新增fixture文件都去conftest.py中追加配置，可以在fixtures包的__init__.py中通过通配符导入把所有fixture对外暴露：

# fixtures/__init__.py
from .core import *
from .users import *

这时候根目录conftest.py中只需要填写fixtures包名即可正常加载所有fixture：

# 项目根目录 conftest.py
pytest_plugins = [
    "fixtures",
]

注意：该方案需要避免不同fixture文件中出现同名fixture，否则后导入的fixture会覆盖先导入的，出现不符合预期的逻辑。如果项目用了flake8等代码检查工具，可以在通配符导入行后加# noqa: F401,F403忽略对应的导入检查警告。

如果配置后还是无法识别fixture，可以通过以下方式定位问题：

• 运行pytest --fixtures -v，命令会输出所有pytest已成功加载的fixture及来源路径，你可以直接搜索自定义fixture的名称确认是否加载成功，若存在导入错误，命令也会输出完整的报错栈。
• 不要将fixture文件命名为和Python内置模块、第三方依赖同名的名称，比如不要叫django.py、pytest.py，否则会出现导入冲突导致加载失败。
• 如果你自定义了pytest的--rootdir运行参数，需要同步调整pytest_plugins中的模块导入路径，保证路径相对于指定的rootdir是可导入的。

内容的提问来源于stack exchange，提问作者Manucho254