Django中CustomUser一对一关联创建对象时出现USERNAME_FIELD缺失错误

问题根源 #

Django Admin默认处理Company模型创建时，不会自动处理关联的UserCompany（CustomUser的代理模型）所需的USERNAME_FIELD（即email）。你的CompanySignUpForm在其他场景正常，是因为表单本身包含了email字段输入和用户创建逻辑，但Admin默认使用的ModelForm没有这些处理步骤。

解决方案 #

1. 修改CompanyAdmin绑定自定义表单 #

将Admin的默认表单替换为你的CompanySignUpForm，复用已验证的用户创建逻辑：

from django.contrib import admin
from .models import Company
from .forms import CompanySignUpForm

class CompanyAdmin(admin.ModelAdmin):
    # 指定使用自定义注册表单
    form = CompanySignUpForm

    def save_model(self, request, obj, form, change):
        # 新增对象时，直接用表单的save方法创建关联用户和公司
        if not change:
            obj = form.save()
        else:
            # 编辑时正常保存公司信息
            obj.save()
        super().save_model(request, obj, form, change)

admin.site.register(Company, CompanyAdmin)

2. 完善CompanySignUpForm的保存逻辑 #

确保表单同时处理UserCompany和Company的创建流程，示例代码：

from django import forms
from .models import Company, UserCompany

class CompanySignUpForm(forms.ModelForm):
    # 添加用户必填的邮箱和密码字段
    email = forms.EmailField(label='企业邮箱', required=True)
    password = forms.CharField(label='登录密码', widget=forms.PasswordInput, required=True)

    class Meta:
        model = Company
        fields = ['name', 'address']  # 替换为你的公司业务字段

    def save(self, commit=True):
        # 创建企业角色的用户
        user = UserCompany.objects.create_user(
            email=self.cleaned_data['email'],
            password=self.cleaned_data['password']
        )
        # 创建公司并关联用户
        company = super().save(commit=False)
        company.user = user
        if commit:
            company.save()
        return company

3. 验证代理模型配置 #

确保UserCompany代理模型自动设置角色，避免手动指定：

class UserCompany(CustomUser):
    class Meta:
        proxy = True
        verbose_name = '企业用户'
        verbose_name_plural = '企业用户'

    def save(self, *args, **kwargs):
        self.role = 'company'  # 强制设置角色为企业
        super().save(*args, **kwargs)

后续Student角色的复用逻辑 #

按照相同模式快速实现：

• 创建UserStudent代理模型，继承CustomUser并强制role='student'
• 创建Student模型，与UserStudent建立一对一关联
• 编写StudentSignUpForm，复用用户+角色实例的创建逻辑
• 配置StudentAdmin，绑定自定义表单并按需重写save_model方法

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