Django使用默认UserCreationForm新增phone字段报Cannot resolve keyword错误

AI 小北

2026-10-3

错误根因

报错Cannot resolve keyword 'phone' into field的核心原因是：你当前表单绑定的是Django默认内置的User模型，该模型本身没有定义phone字段，你在表单的clean_phone方法中对User表执行phone__iexact过滤、表单尝试将phone字段值写入User模型的操作都会触发字段不存在的错误。

排查思路

先确认项目的用户模型配置：检查settings.py中是否配置了AUTH_USER_MODEL参数，未配置则默认使用Django内置的auth.User模型，该模型确实没有phone字段
检查clean_phone方法逻辑：该方法直接调用User.objects.filter(phone__iexact=phone)查询，User表无对应字段必然报错
检查表单字段配置：你在表单Meta的fields中加入了phone，表单执行save操作时会默认尝试将phone值写入User模型的对应字段，找不到字段也会触发报错

解决方案

方案1：扩展自定义用户模型（推荐，适配新项目）

新建自定义用户模型，继承AbstractUser并添加phone字段

# models.py
from django.contrib.auth.models import AbstractUser
from django.db import models

class CustomUser(AbstractUser):
    phone = models.CharField(max_length=10, unique=True, verbose_name="手机号")

在settings.py中配置自定义用户模型

# settings.py
AUTH_USER_MODEL = "你的应用名称.CustomUser"

修改forms.py的表单绑定模型

# forms.py
from .models import CustomUser

class SignUpForm(UserCreationForm):
    # 原有phone_regex、email、phone字段定义保持不变
    class Meta:
        model = CustomUser # 将原来的User替换为CustomUser
        fields = ('username', 'email', 'phone', 'password1', 'password2',)
    # 后续clean方法无需修改，CustomUser已包含phone字段，过滤操作可正常执行

执行python manage.py makemigrations和python manage.py migrate命令同步数据库结构
注意：如果项目已经执行过迁移生成了默认User表，需要先清理旧的迁移文件和数据库再执行上述操作，避免迁移冲突。

方案2：关联Profile模型存储手机号（适配已有老项目，不希望修改原有用户模型的场景）

新建Profile模型和User做一对一关联

# models.py
from django.contrib.auth.models import User
from django.db import models

class UserProfile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE, related_name="profile")
    phone = models.CharField(max_length=10, unique=True, verbose_name="手机号")

修改forms.py配置，调整手机号查重逻辑

class SignUpForm(UserCreationForm):
    # 原有phone_regex、email、phone字段定义保持不变
    class Meta:
        model = User
        fields = ('username', 'email', 'password1', 'password2',) # 把phone从字段列表移除
    
    def clean_phone(self):
        phone = self.cleaned_data['phone']
        # 改为查询UserProfile表判断手机号是否重复
        qs = UserProfile.objects.filter(phone__iexact=phone)
        if qs.exists():
            raise ValidationError('该手机号已被注册')
        return phone

修改views.py的保存逻辑，User保存完成后手动创建关联的Profile存储手机号

def post(self, request, *args, **kwargs):
    form = self.form_class(request.POST)
    if form.is_valid():
        user = form.save(commit=False)
        user.is_active = False
        user.save()
        # 新增代码段：创建用户关联的Profile存手机号
        UserProfile.objects.create(
            user=user,
            phone=form.cleaned_data['phone']
        )
        # 原有发邮件、跳转逻辑保持不变

执行python manage.py makemigrations和python manage.py migrate命令同步数据库结构

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