Django Admin未识别模型blank=True，自定义表单校验必填异常

问题描述 #

在Django管理面板使用自定义CustomUserChangeForm编辑用户时，模型中已设置blank=True的display_name、bio、profile_picture字段被校验强制要求填写，但这些字段本应是可选的。此前CustomUserCreationForm也出现过同类问题，改用默认表单后恢复正常（仅需填写username、password1和password2，其余字段可留空）。

问题原因 #

当你在自定义表单中手动重新声明字段时，Django表单字段默认required=True，这个设置会覆盖模型中blank=True的配置，导致这些字段被判定为必填项。

解决方案 #

有两种方式可以解决这个问题：

方式一：给手动声明的字段添加required=False

在重新定义表单字段时，明确指定required=False，让表单尊重模型的可选设置：

修改后的forms.py代码：

from django import forms
from django.contrib.auth.forms import UserChangeForm
from .models import CustomUser

class CustomUserChangeForm(UserChangeForm):
    display_name = forms.CharField(label="显示名称", required=False)
    bio = forms.CharField(widget=forms.Textarea, required=False)
    profile_picture = forms.ImageField(label="头像", required=False)

    class Meta():
        model = CustomUser
        fields = ("username", "email", "display_name", "bio", "profile_picture")

方式二：不手动声明字段，让Django自动生成

如果不需要自定义字段的label或widget，可直接通过Meta类的fields指定要显示的字段，Django会自动根据模型中blank=True的配置，将对应表单字段设为非必填：

修改后的forms.py代码：

from django import forms
from django.contrib.auth.forms import UserChangeForm
from .models import CustomUser

class CustomUserChangeForm(UserChangeForm):
    class Meta():
        model = CustomUser
        fields = ("username", "email", "display_name", "bio", "profile_picture")

如果需要自定义某个字段的样式（比如bio用Textarea），只需要单独声明该字段并加上required=False即可：

bio = forms.CharField(widget=forms.Textarea, required=False, label="个人简介")

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