使用pytest-django测试时Django connections对象无法识别第二个数据库表

我来帮你一步步排查这个问题，大概率是数据库配置、查询指定或者测试环境初始化的环节出了疏漏：

1. 先补全第二个数据库的配置 #

你提供的settings.py片段里只有default数据库的配置，但你要查询的是customers库——相当于要访问一个没在系统里登记的地址，Django自然找不到它。先把customers的配置补充到DATABASES字典中：

DATABASES = {
    'default': {
        'NAME': 'user_data',
        'ENGINE': 'django.db.backends.postgresql',  # 替换成你实际用的数据库引擎，比如mysql/sqlite
        'USER': 'your_db_user',
        'PASSWORD': 'your_db_password',
        'HOST': 'localhost',
        'PORT': '5432',
    },
    'customers': {
        'NAME': 'customers',  # 必须和你实际的数据库名完全一致
        'ENGINE': 'django.db.backends.postgresql',
        'USER': 'your_db_user',  # 如果和default用同一个用户就复用，否则填对应账号
        'PASSWORD': 'your_db_password',
        'HOST': 'localhost',
        'PORT': '5432',
    }
}

2. 确保查询或模型指定了正确的数据库 #

就算配置了第二个数据库，Django默认还是会用default库执行操作，你需要明确指定目标数据库：

方式一：查询时直接用using指定 #

# 假设你的模型是Customer
from yourapp.models import Customer

# 强制使用customers数据库查询
customers = Customer.objects.using('customers').all()

方式二：用数据库路由自动分配 #

如果多个模型都属于customers库，可以写一个路由类，让Django自动把对应模型的操作路由到目标库：

# 在你的app下创建routers.py文件
class CustomerRouter:
    def db_for_read(self, model, **hints):
        # 把指定app下的模型路由到customers库
        if model._meta.app_label == 'customers_app':
            return 'customers'
        return None

    def db_for_write(self, model, **hints):
        if model._meta.app_label == 'customers_app':
            return 'customers'
        return None

    def allow_relation(self, obj1, obj2, **hints):
        # 允许同库内的模型建立关联
        if obj1._meta.app_label == 'customers_app' and obj2._meta.app_label == 'customers_app':
            return True
        return None

然后在settings.py里添加路由配置：

DATABASE_ROUTERS = ['yourapp.routers.CustomerRouter']

3. 让pytest-django正确初始化第二个数据库 #

pytest-django默认只会处理default数据库，你需要手动确保customers库的测试环境就绪：

• 先把迁移应用到customers库：

python manage.py migrate --database=customers

• 在测试中明确使用customers的连接：

from django.db import connections

def test_customers_table_exists():
    # 用customers数据库的游标执行查询，验证表存在
    with connections['customers'].cursor() as cursor:
        cursor.execute("SELECT 1 FROM your_target_table LIMIT 1")
        result = cursor.fetchone()
        assert result is not None

• 如果测试需要创建数据，记得指定数据库：

def test_create_customer():
    Customer.objects.using('customers').create(name="Test Customer")
    assert Customer.objects.using('customers').count() == 1

4. 注意跨数据库关联的限制 #

如果错误提示是关于表关联不存在，要检查是不是用了跨数据库的外键——Django默认不支持跨数据库的ForeignKey关联！如果你的模型里有跨库外键（哪怕加了db_constraint=False），Django无法自动处理关联查询，你需要手动通过ID关联数据，不要依赖ORM的关联特性。

最后几个验证点 #

• 确认customers数据库确实存在，且里面已经创建了对应表（可以用数据库客户端直接连接查看）
• 确认pytest加载的是正确的settings文件（比如不要用单独的test_settings.py却没配置customers库）
• 如果用了--reuse-db参数，尝试删除测试数据库重新创建，避免残留错误状态

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