pytest-django执行测试时提示Site模型未声明app_label错误，但manage.py runserver运行正常

我太懂这种头疼的情况了——本地跑开发服务器一切顺畅，一到pytest收集测试就报模型没声明app_label，这种不一致真的让人摸不着头脑。咱们一步步来排查解决：

1. 给app指定默认的AppConfig #

先看看director/apps/sites/__init__.py文件，里面有没有告诉Django该用哪个AppConfig？如果是空的，添上这一行：

default_app_config = "director.apps.sites.SitesConfig"

这一步能确保Django在导入这个app模块时，直接关联到你定义的SitesConfig，避免自动检测时出现路径识别偏差。

2. 显式指定AppConfig到INSTALLED_APPS #

你现在在INSTALLED_APPS里写的是"director.apps.sites"，可以试试换成完整的AppConfig类路径：

"director.apps.sites.SitesConfig",

pytest的导入上下文和runserver有时候不太一样，显式指定能消除这种模糊性，让Django明确知道这个app的配置来源。

3. 检查测试文件的导入方式 #

确认director/apps/sites/tests.py和相关模块（比如parser.py）里的导入都是相对导入：

• 比如用from . import parser而不是from director.apps.sites import parser
• 模型导入用from .models import DockerAction, DockerImage, Domain而不是from sites.models import ...

绝对导入容易让Django把sites当成独立的app，而不是director.apps.sites的子模块，自然就找不到对应的app_label了。

4. 修正pytest的rootdir配置 #

看你pytest输出里的rootdir是/home/jasongrace2282/repos/website5/manager，但你的manage.py和director目录是在项目根目录（和pyproject.toml同级）。这种路径不一致可能导致导入问题，建议在pyproject.toml里明确指定rootdir：

[tool.pytest.ini_options]
DJANGO_SETTINGS_MODULE = "director.settings"
python_files = ["tests.py", "test_*.py"]
rootdir = "."

确保pytest的根目录和runserver运行的目录一致，这样导入路径才会匹配。

5. 清除pytest缓存 #

有时候旧的缓存会导致奇怪的导入问题，先删掉缓存目录再重试：

rm -rf .pytest_cache
pytest --collectonly --verbose -n0

这些操作应该能解决pytest和runserver之间的识别差异，核心就是让Django在pytest的环境里，能正确找到app的配置和模型的归属。

备注：内容来源于stack exchange，提问作者Jason Grace