Django如何实现模型两字段互斥且至少必填一项的校验

核心逻辑：不需要强行让两个字段保持数据库层面的非空约束，通过Django自带的校验机制拦住「两个字段都为空」的提交，从业务逻辑层面保证数据库里的记录永远至少有一个字段有值，完全不会影响模板渲染。

1. 模型层配置（核心） #

首先调整两个字段的属性，允许数据库和表单层面存储空值，再通过模型内置的clean方法写入二选一必填的校验规则，同时加一个统一的取值方法，简化模板层的调用逻辑：

from django.db import models
from django.core.exceptions import ValidationError

class Image(models.Model):
    # 其余原有字段保持不变
    image = models.ImageField(upload_to='some_place', null=True, blank=True)
    image_url = models.URLField(null=True, blank=True)

    def clean(self):
        super().clean()
        # 校验：两个字段不能同时为空
        if not self.image and not self.image_url:
            raise ValidationError("本地上传图片、图片外链必须填写其中一项")
        # 可选规则：如果需要禁止同时填写两个字段，就保留下面这段判断，不需要可以删除
        if self.image and self.image_url:
            raise ValidationError("本地上传图片、图片外链只能填写其中一项")

    def get_show_image_url(self):
        """统一返回可直接用于img标签src属性的地址，模板层不需要单独判断字段"""
        if self.image:
            return self.image.url
        return self.image_url

注意：如果你是在视图中手动实例化模型、调用save()方法存数据，没有使用Django的ModelForm，必须在保存前主动调用full_clean()方法，否则上面的自定义校验不会自动触发。手动调用的示例代码如下：

def image_submit_view(request):
    if request.method == "POST":
        img_instance = Image(
            image=request.FILES.get("image"),
            image_url=request.POST.get("image_url")
        )
        try:
            # 触发全量校验，包含上面写的clean规则
            img_instance.full_clean()
            img_instance.save()
            # 跳转成功页逻辑
        except ValidationError as e:
            # 校验失败，把错误信息返回给前端
            return render(request, "submit.html", {"errors": e.message_dict})
    return render(request, "submit.html")

2. 表单层校验（双保险，可选） #

如果你用ModelForm处理用户提交，可以在表单层再加一层相同逻辑的校验，和模型层校验不冲突，容错性更高：

from django import forms
from .models import Image

class ImageSubmitForm(forms.ModelForm):
    class Meta:
        model = Image
        fields = ["image", "image_url"]

    def clean(self):
        cleaned_data = super().clean()
        input_image = cleaned_data.get("image")
        input_image_url = cleaned_data.get("image_url")

        if not input_image and not input_image_url:
            raise forms.ValidationError("请选择本地上传图片，或者填写外链图片地址")
        # 同样可选：禁止同时填写两个字段
        if input_image and input_image_url:
            raise forms.ValidationError("本地上传和外链地址二选一即可，不需要同时填写")
        return cleaned_data

3. 模板层使用 #

因为校验逻辑已经保证所有存入数据库的记录至少有一个图片字段有值，直接调用模型里写好的统一取值方法即可，不需要额外写判断逻辑：

<img src="{{ image_obj.get_show_image_url }}" alt="提交的图片">

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