为何Django的full_clean在非默认数据库下无法正常工作？

核心问题 #

你在使用Django多数据库架构时，调用full_clean()会触发字段重复的错误，但目标数据库（validation）中并没有对应的数据——这是因为full_clean()默认会使用默认数据库执行唯一性校验，而你的default库中已经存在这条测试数据。

原因分析 #

Django模型的full_clean()方法会触发字段的内置验证器（比如unique=True对应的验证逻辑），这些验证器默认使用模型的默认管理器查询数据，而默认管理器默认连接的是default数据库，和你后续save(using="validation")指定的数据库无关。这就导致明明要往validation库存数据，校验时却去default库查询，最终误判为重复。

解决方案 #

方案1：手动校验目标数据库，跳过默认唯一性验证 #

直接在目标数据库中手动检查字段唯一性，再调用full_clean()时排除这些字段的默认校验：

from django.core.exceptions import ValidationError

new_compound_dict = {
    "name": "test",
    "formula": "C1H4",
    "hmdb_id": "HMBD0000001",
}
new_compound = Compound(**new_compound_dict)

# 手动在validation数据库校验唯一性
if Compound.objects.using("validation").filter(name=new_compound.name).exists():
    raise ValidationError({"name": ["Compound with this Name already exists."]})
if Compound.objects.using("validation").filter(hmdb_id=new_compound.hmdb_id).exists():
    raise ValidationError({"hmdb_id": ["Compound with this HMDB ID already exists."]})

# 调用full_clean时排除已手动校验的字段
new_compound.full_clean(exclude=["name", "hmdb_id"])
new_compound.save(using="validation")

方案2：临时切换模型默认管理器的数据库 #

临时修改模型默认管理器的数据库别名，让full_clean()使用目标数据库校验，之后恢复原配置：

new_compound_dict = {
    "name": "test",
    "formula": "C1H4",
    "hmdb_id": "HMBD0000001",
}

# 保存原默认管理器的数据库配置
original_db = Compound.objects.db
# 临时切换到validation数据库
Compound.objects.db = "validation"

try:
    new_compound = Compound(**new_compound_dict)
    new_compound.full_clean()
    new_compound.save(using="validation")
finally:
    # 必须恢复原配置，避免影响其他业务逻辑
    Compound.objects.db = original_db

方案3：自定义支持指定数据库的唯一性验证器 #

如果需要长期在非默认数据库做校验，可以自定义验证器替换默认逻辑，支持指定数据库：

# 自定义验证器
from django.core.exceptions import ValidationError
from django.db.models import UniqueValidator

class DBUniqueValidator(UniqueValidator):
    def __init__(self, using=None, **kwargs):
        self.using = using
        super().__init__(**kwargs)
    
    def __call__(self, value, model_instance):
        # 使用指定数据库执行查询
        queryset = self.queryset.using(self.using) if self.using else self.queryset
        if queryset.filter(**{self.field_name: value}).exists():
            raise ValidationError(self.message, code=self.code)

# 修改模型字段的验证器
from django.db import models

class Compound(models.Model):
    name = models.CharField(
        max_length=255,
        validators=[
            DBUniqueValidator(
                queryset=Compound.objects.all(),
                using="validation",
                message="Compound with this Name already exists."
            )
        ],
        unique=True
    )
    hmdb_id = models.CharField(
        max_length=255,
        validators=[
            DBUniqueValidator(
                queryset=Compound.objects.all(),
                using="validation",
                message="Compound with this HMDB ID already exists."
            )
        ],
        unique=True
    )
    formula = models.CharField(max_length=255)

这个方案适合固定使用validation数据库做校验的场景，如果需要动态切换数据库，可以在验证器中通过模型实例属性传递数据库别名，提升灵活度。

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