Pytest未读取pytest.ini中DJANGO_SETTINGS_MODULE配置问题排查

我之前也踩过pytest-django配置的坑，结合你的描述，咱们来一步步排查解决这个头疼的问题：

1. 先确认pytest.ini的绝对正确格式 #

首先要死死盯住你的pytest.ini：它必须放在包含manage.py的项目根目录，而且[pytest]头部绝对不能丢，正确配置示例如下：

[pytest]
# 替换成你实际的settings模块路径，比如myproject.settings
DJANGO_SETTINGS_MODULE = your_project.settings

如果你的settings在子目录（比如config/settings.py），就写config.settings，别写错层级。

2. 检查Python路径与虚拟环境一致性 #

你提到单独设环境变量后报ImportError，这大概率是Python找不到你的settings模块，核心问题在路径：

• 先确认运行pytest的终端，和运行python manage.py的是同一个虚拟环境？不同环境的Python路径完全独立，很容易导致模块找不到。
• 验证路径是否正确：在项目根目录运行python -c "import your_project.settings; print(your_project.settings)"，如果能正常打印模块路径，说明Python能找到；如果报错，就把项目根目录强行加入Python路径——在项目根目录创建conftest.py，添加以下代码：

  import sys
  from pathlib import Path
  
  # 把项目根目录加入Python搜索路径
  sys.path.insert(0, str(Path(__file__).resolve().parent))
  

3. 排查版本兼容性问题 #

你用的pytest-django==2.9.1是2017年的老版本了，和新版本Django可能存在兼容性冲突。建议先升级到最新稳定版试试：

pip install --upgrade pytest-django

很多老版本的配置bug在新版本里已经被修复，升级后再重新跑测试，说不定问题直接消失。

4. 确保--ds参数的正确用法 #

你说--ds参数无效，可能是写法不对，正确的运行命令应该是这样的（在项目根目录执行）：

pytest --ds=your_project.settings

注意不要加引号，直接写完整的settings模块路径，别漏了项目名前缀。

5. 检查settings模块本身的隐藏问题 #

虽然python manage.py能正常运行，但有可能你的settings里存在测试环境触发的导入问题：比如某些生产依赖在测试环境没安装，或者代码逻辑在非manage.py启动时会出错？

• 验证settings本身是否能正常加载：在项目根目录运行python -m django settings --settings=your_project.settings CACHES，如果能正常输出CACHES配置，说明settings没问题；如果报错，就得先修复settings里的代码问题。

终极兜底方案：在conftest.py手动配置settings #

如果以上方法都没用，咱们绕开pytest.ini，直接在项目根目录的conftest.py里手动初始化Django设置：

import django
from django.conf import settings

def pytest_configure():
    if not settings.configured:
        # 手动配置必要的Django设置，根据你的项目调整
        settings.configure(
            DEBUG=True,
            SECRET_KEY='test-only-secret-key',
            INSTALLED_APPS=[
                'django.contrib.contenttypes',
                'django.contrib.auth',
                # 加上你的项目app
                'your_app',
            ],
            DATABASES={
                'default': {
                    'ENGINE': 'django.db.backends.sqlite3',
                    'NAME': ':memory:',
                }
            },
            # 必须配置CACHES，解决你遇到的报错
            CACHES={
                'default': {
                    'BACKEND': 'django.core.cache.backends.locmem.LocMemCache',
                }
            }
        )
        django.setup()

这样pytest运行时会直接用这个手动配置，彻底避开自动加载的坑。

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