Django自定义用户模型email字段仍必填及管理器优化求助

一、Email字段已设null/blank但表单仍必填的问题 #

问题原因 #

你在模型中重写了email字段并设置blank=True, null=True，但Django默认的用户管理表单（UserCreationForm、UserChangeForm）并未自动同步这个配置——这些表单基于AbstractUser的原始字段定义生成，依然会将email标记为必填项。

解决方案 #

自定义Admin表单和用户管理配置，让表单继承你重写字段的属性：

1. 在admin.py中编写自定义表单与Admin类：

from django.contrib import admin
from django.contrib.auth.admin import UserAdmin
from django.contrib.auth.forms import UserCreationForm, UserChangeForm
from .models import User

class CustomUserCreationForm(UserCreationForm):
    class Meta(UserCreationForm.Meta):
        model = User
        fields = ('username', 'email', 'phone')  # 按需调整显示字段

class CustomUserChangeForm(UserChangeForm):
    class Meta(UserChangeForm.Meta):
        model = User

class CustomUserAdmin(UserAdmin):
    add_form = CustomUserCreationForm
    form = CustomUserChangeForm
    
    # 配置Admin页面的字段分组，明确email为非必填
    fieldsets = (
        (None, {'fields': ('username', 'password')}),
        ('个人信息', {'fields': ('email', 'phone', 'first_name', 'last_name', 'middle_name', 'gender')}),
        ('权限设置', {'fields': ('is_active', 'is_staff', 'is_superuser', 'groups', 'user_permissions')}),
        ('重要日期', {'fields': ('last_login', 'date_joined', 'user_verified_at', 'phone_verified_at', 'telegram_linked_at')}),
    )
    add_fieldsets = (
        (None, {
            'classes': ('wide',),
            'fields': ('username', 'email', 'password1', 'password2'),
        }),
    )

admin.site.register(User, CustomUserAdmin)

2. 额外建议：将email字段从CharField改为EmailField，Django会自动处理邮箱格式验证，更符合业务需求：

email = models.EmailField(_('Email'), max_length=30, unique=True, blank=True, null=True)

二、UserManager中用户名规则未生效的问题 #

问题原因 #

UserManager的核心职责是处理用户创建逻辑，而非字段验证。你想添加的用户名长度、正则规则，需要放在模型的验证方法或表单验证中才能生效——仅在_create_user里检查是否为空是不够的。

解决方案 #

方案1：模型层验证（全局生效，无论通过何种方式创建用户）

在User模型中添加clean()方法，统一处理用户名验证：

import re
from django.core.exceptions import ValidationError
from django.contrib.auth.models import AbstractUser
from django.db import models
from django.utils.translation import gettext_lazy as _

from .managers import UserManager

class User(AbstractUser):
    # ... 现有字段定义 ...

    def clean(self):
        super().clean()
        # 验证用户名长度
        if len(self.username) < 3 or len(self.username) > 30:
            raise ValidationError({'username': '用户名长度必须在3-30字符之间'})
        # 验证用户名格式（仅允许字母、数字、下划线、点）
        username_pattern = r'^[\w.]+$'
        if not re.match(username_pattern, self.username):
            raise ValidationError({'username': '用户名仅支持字母、数字、下划线和点'})
        # 检查是否为保留用户名
        if ReservedUsername.objects.filter(username=self.username).exists():
            raise ValidationError({'username': '该用户名已被保留'})

方案2：表单层验证（仅在表单提交时生效，比如注册页面）

如果只需要在用户通过表单注册时验证，可以自定义表单：

import re
from django import forms
from .models import User, ReservedUsername

class UserRegisterForm(forms.ModelForm):
    password1 = forms.CharField(label='密码', widget=forms.PasswordInput)
    password2 = forms.CharField(label='确认密码', widget=forms.PasswordInput)

    class Meta:
        model = User
        fields = ('username', 'email')

    def clean_username(self):
        username = self.cleaned_data.get('username')
        # 长度验证
        if len(username) not in range(3, 31):
            raise forms.ValidationError('用户名长度必须在3-30字符之间')
        # 格式验证
        if not re.match(r'^[\w.]+$', username):
            raise forms.ValidationError('用户名仅支持字母、数字、下划线和点')
        # 保留用户名检查
        if ReservedUsername.objects.filter(username=username).exists():
            raise forms.ValidationError('该用户名已被保留')
        return username

    def clean_password2(self):
        password1 = self.cleaned_data.get('password1')
        password2 = self.cleaned_data.get('password2')
        if password1 and password2 and password1 != password2:
            raise forms.ValidationError('两次输入的密码不一致')
        return password2

    def save(self, commit=True):
        user = super().save(commit=False)
        user.set_password(self.cleaned_data['password1'])
        if commit:
            user.save()
        return user

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