Django测试执行特定模块时错误使用非测试数据库的原因排查

首先，我来分析你遇到的问题：全量测试时自定义TestRunner能正确切换到测试数据库test_postgresdevuser，但指定单个模块测试时却意外使用了生产库postgresdevuser。结合你的Django版本（3.0.7）、配置和自定义TestRunner代码，我整理了以下排查方向和解决方案：

核心原因分析 #

从你的配置和输出来看，问题出在测试数据库的初始化触发逻辑和自定义TestRunner的覆盖范围上：

1. 你在settings.py中没有明确指定TEST.NAME，依赖Django自动生成test_前缀的测试库，但在特定模块测试场景下，Django的默认测试数据库初始化流程可能没有被完全触发。
2. 你的自定义KeepDBTestRunner仅设置了keepdb=True和db_base_name，但没有在关键的测试数据库初始化阶段主动修改数据库连接配置，导致特定场景下无法正确切换。

解决方案 #

方案1：在settings中明确指定测试数据库名称（最直接有效） #

修改settings.py中的数据库配置循环，直接为每个数据库指定测试库名称，避免依赖Django自动生成逻辑：

for db_name in DATABASES:
    DATABASES[db_name]['TEST'] = {
        'SERIALIZE': False,
        'DEPENDENCIES': [],
        'NAME': 'test_postgresdevuser'  # 强制指定测试库名
    }

这样无论全量还是特定模块测试，Django都会优先使用这个明确配置的测试数据库，从根源上避免切换错误。

方案2：修复自定义TestRunner，主动控制数据库切换 #

你的KeepDBTestRunner需要覆盖setup_databases方法（Django测试流程中负责初始化测试数据库的核心方法），确保在所有测试场景下强制切换到测试库：

from django import db
from django.test.runner import DiscoverRunner

class KeepDBTestRunner(DiscoverRunner):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.verbosity = 2
        self.keepdb = True
        self.db_base_name = 'test_postgresdevuser'

    def setup_databases(self, **kwargs):
        # 强制修改所有数据库别名的测试库配置
        for alias in db.connections:
            # 直接设置TEST.NAME为目标测试库
            db.connections.databases[alias]['TEST']['NAME'] = self.db_base_name
            # 同时确保当前连接的NAME也被更新（防止提前初始化的连接未切换）
            if hasattr(db.connections[alias], 'settings_dict'):
                db.connections[alias].settings_dict['NAME'] = self.db_base_name
        # 调用父类方法完成数据库初始化
        return super().setup_databases(**kwargs)

    def run_checks(self):
        super().run_checks()
        print(db.connections.databases)

这个修改会在测试启动阶段主动覆盖所有数据库的连接配置，确保无论测试范围如何，都使用指定的测试库。

排查验证步骤 #

1. 临时移除--keepdb参数测试：运行特定模块测试时去掉--keepdb，看是否会自动创建test_postgresdevuser并切换过去。如果可以，说明问题与keepdb复用逻辑有关，此时方案2的修复会更稳妥。
2. 提高测试日志 verbosity：添加--verbosity=3参数运行测试，查看输出中关于数据库初始化的详细日志，确认是否有测试数据库未被创建/切换的提示。
3. 检查测试用例代码：确认apps.my_module的测试用例中没有手动修改数据库连接的代码（比如直接操作db.connections），避免代码逻辑覆盖了测试配置。

内容的提问来源于stack exchange，提问作者Ярига Олег