Django运行单元测试报DISTINCT ON字段不被数据库后端支持错误

问题表现 #

• 业务接口正式运行时功能正常，无报错
• 执行单元测试时抛出异常：DISTINCT ON fields is not supported by this database backend
• 手动在配置中指定测试库为提前创建的mytestdatabase后，测试运行时未连接到该库，无法确认配置是否生效

根因说明 #

DISTINCT ON是PostgreSQL专属SQL语法，仅PostgreSQL数据库后端支持该语法。出现该报错的核心原因是测试运行时未使用你配置的PostgreSQL数据库，实际连接的是SQLite数据库（Django测试场景下最常见的默认回退选项），SQLite不支持该语法因此抛出异常。

配置不生效的常见修复方案 #

1. 排查配置覆盖问题 #

• 确认执行测试时加载的settings文件正确：检查环境变量DJANGO_SETTINGS_MODULE是否指向你配置了PostgreSQL的settings文件，避免误加载测试专用的、配置了SQLite的settings文件（比如部分项目会拆分dev/prod/test多环境settings，test环境默认配了SQLite）。可以在对应settings文件末尾加打印语句print(DATABASES["default"]["ENGINE"])，跑测试时如果输出的不是django.db.backends.postgresql_psycopg2，就说明加载了错误的配置。
• 排查第三方测试包的默认配置：部分测试加速、测试增强类第三方包（比如部分版本的测试工具包）默认会自动把测试数据库替换为SQLite内存库以提升运行速度，这类配置需要手动关闭，禁止自动替换数据库后端。

2. 修正数据库配置写法 #

Django的DATABASES配置中，TEST字段下的连接参数（ENGINE/USER/PASSWORD/HOST/PORT）默认会继承外层default节点的配置，重复书写这些参数在部分Django版本中会出现解析异常。正确的精简配置如下：

DATABASES = {
    "default": {
        "NAME": "my_database",
        "USER": "postgres",
        "PASSWORD": "postgres",
        "HOST": "localhost",
        "PORT": 5435,
        "ENGINE": "django.db.backends.postgresql_psycopg2",
        "TEST": {
            "NAME": "mytestdatabase",
            "TEMPLATE": "template0" # 避免PostgreSQL建库时的模板权限问题
        },
    }
}

3. 验证测试数据库连接 #

• 确保配置的PostgreSQL账号对mytestdatabase有完整权限：如果是提前手动创建的库，要保证运行测试的账号有建表、删表、读写的完整权限；如果不提前建库，Django会自动用指定的账号创建该测试库，要保证账号有建库权限。
• 跑测试时加-v 3参数输出详细日志，查看测试启动阶段的数据库连接信息，确认实际连接的库名、引擎是否符合预期：

  python manage.py test -v 3
  

4. pytest场景额外配置 #

如果你用pytest+pytest-django跑测试，需要在pytest.ini中显式指定正确的settings路径，不要加任何指定SQLite作为测试库的参数，参考配置：

[pytest]
DJANGO_SETTINGS_MODULE = 你的项目.settings模块路径
addopts = -v 3 --reuse-db

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