Django 5.1使用db_default字段调用full_clean()触发验证错误

问题根源 #

db_default是Django 5新增的数据库层面默认值配置，它仅作用于数据库表结构（在CREATE TABLE时添加DEFAULT约束），不会自动将默认值填充到模型实例的Python属性中。当调用full_clean()时，Django会对模型实例的字段值做类型校验，此时未赋值的字段会持有DatabaseDefault对象，而非符合字段类型的实际值（比如布尔字段需要True/False），因此触发ValidationError。

正确用法与解决方案 #

1. 明确db_default与default的差异

• default：Python层面的默认值，创建实例时会自动赋值给字段，full_clean()能正常通过校验
• db_default：仅在数据库端设置默认值，Python实例不会自动获取该值，适合需要数据库层面控制默认逻辑，但Python代码中允许字段暂不赋值的场景

2. 解决full_clean()报错的方案

• 方案一：同时设置default和db_default（推荐）
  如果需要同时兼顾Python层面的验证和数据库默认值约束，可将两个参数同时设置（确保值一致）：

  editable = models.BooleanField(default=True, db_default=True)
  

  这样创建实例时Python属性会自动得到默认值，full_clean()校验通过，同时数据库表也会带上DEFAULT约束。

• 方案二：在模型clean()方法中手动处理
  若仅需数据库层面的默认值，可重写模型的clean()方法，将DatabaseDefault对象替换为实际默认值：

  from django.db.models.expressions import DatabaseDefault
  
  class YourModel(models.Model):
      editable = models.BooleanField(db_default=True)
  
      def clean(self):
          # 检测字段值是否为DatabaseDefault对象，替换为实际默认值
          if isinstance(self.editable, DatabaseDefault):
              self.editable = True
          super().clean()
  

• 方案三：创建实例时手动赋值
  在创建模型实例时直接指定字段值，或者调用full_clean()前手动赋值：

  obj = YourModel()
  obj.editable = True  # 手动赋值
  obj.full_clean()
  obj.save()
  

3. 额外注意事项

• 使用db_default创建实例后，若不调用refresh_from_db()，模型实例的字段值不会同步数据库设置的默认值（因为Python实例与数据库状态是分离的）
• 对带choices约束的字段（如CharField），同样需注意Python层面的字段值校验，db_default仅负责数据库端的默认值，不会自动同步到Python实例的属性中

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