Django模型CheckConstraint如何校验两字段至少一个为非空字符串

Django ORM 的 Q 表达式不支持字段__lookup!= 值这类运算符写法，要实现取反判断，直接在 Q 对象前添加~前缀表示逻辑非即可，该写法完全兼容 CheckConstraint 校验场景。

你的需求本质是禁止firstname和surname两个字段同时为空，不需要枚举所有合法的字段组合，直接对「两个字段同时为空串」的场景做取反判断即可，逻辑更简洁。

正确实现代码 #

from django.db import models
from django.db.models import Q

class Person(models.Model):
    firstname = models.CharField(max_length=150, blank=True, null=False, default="")
    surname = models.CharField(max_length=150, blank=True, null=False, default="")

    class Meta:
        constraints = [
            models.CheckConstraint(
                name="%(app_label)s_%(class)s_firstname_and_or_surname",
                # 核心逻辑：不允许名和姓同时为空字符串
                check=~Q(firstname__exact="", surname__exact=""),
            )
        ]

逻辑说明 #

• ~Q(xxx) 的效果和 QuerySet 操作中exclude(xxx)完全等价，会在数据库层面生成NOT (条件)的校验规则，自动覆盖所有合法场景：
  • firstname为空字符串、surname为非空值
  • firstname为非空值、surname为空字符串
  • firstname、surname均为非空值
• 由于你的字段已经设置null=False，不存在字段值为NULL的情况，不需要额外添加__isnull相关判断，当前约束逻辑已经完全满足业务要求。
• 不要尝试自定义__exact!=这类非法lookup写法，Django所有取反类查询都可以通过~Q()组合实现，这是官方原生支持的标准写法。

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