Django自定义用户模型的注册ModelForm校验通过却无法保存，如何调试？

故障根因定位 #

你观察到的“clean_phone_number方法内日志正常输出，但表单save方法内日志无输出、数据未入库”的现象，本质是表单整体校验未通过，未进入form_valid执行分支：

• Django表单的校验是按字段定义顺序逐个执行的，phone_number是你表单里定义的第一个字段，所以它的clean方法会先执行、打出日志；但排在它后面的任意字段如果校验失败，整个表单的is_valid()方法就会返回False，Django会直接渲染表单页展示错误，根本不会执行form_valid里手动调用的form.save()代码，自然触发不了save方法里的日志。
• 快速验证方法：在视图中重写form_invalid方法，打印所有校验错误，就能直接看到具体的失败原因：

def form_invalid(self, form):
    print("表单校验失败详情：", form.errors.as_json())
    return super().form_invalid(form)

代码内的已知硬伤 #

表单层问题 #

• ModelForm的Meta.fields列表中包含了password1、password2两个不属于User模型的自定义临时字段，ModelForm初始化时就会抛出未知字段的错误
• 没有实现clean_password2方法做两次密码的一致性校验，两次密码输入不一致时会直接触发校验失败
• 把phone_number定义为IntegerField类型不符合业务逻辑：手机号不需要做整数运算，IntegerField会自动丢失前导0，也无法存储带格式的号码；同时你的校验逻辑依赖字符串的len()、isdigit()方法，和IntegerField的类型转换逻辑不匹配
• save方法逻辑冗余：先调用super().save()（默认会直接把数据写入数据库）再设置密码、二次保存，会产生不必要的数据库查询

视图层问题 #

• 搭配ModelForm做数据写入时选错了通用视图基类：FormView仅用于处理普通表单逻辑，没有内置的ModelForm保存逻辑，需要手动写大量重复代码；只要涉及模型数据写入，应该优先使用CreateView
• form_valid方法没有返回合法的重定向响应，打印完日志就直接结束，会导致页面渲染异常
• 保存完用户后手动调用authenticate属于多余逻辑：用户是刚在save方法中完成密码设置的，不需要重复做认证校验

修正后的参考实现 #

修正后的注册表单 #

class RegisterForm(forms.ModelForm):
    phone_number = forms.CharField(required=True, min_length=10, max_length=10)
    password1 = forms.CharField(widget=forms.PasswordInput())
    password2 = forms.CharField(widget=forms.PasswordInput())
    country_code = forms.CharField()

    class Meta:
        model = User
        fields = ['username','country_code','phone_number', 'full_name']

    def clean_phone_number(self):
        phone_number = self.cleaned_data.get('phone_number')
        if User.objects.filter(phone_number=phone_number).exists():
            raise forms.ValidationError("该手机号已被注册")
        if not phone_number.isdigit():
            raise forms.ValidationError("请输入10位有效手机号")
        return phone_number

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

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

修正后的视图 #

class RegisterView(SuccessMessageMixin, CreateView):
    template_name = 'register-2.html'
    form_class = RegisterForm
    success_url = "/login/"
    success_message = "OTP已发送至你的注册手机号，验证码10分钟内有效。"

    def form_valid(self, form):
        user = form.save()
        # 后续可扩展发送OTP的逻辑
        return super().form_valid(form)

新手调试技巧与参考资源 #

• 调试表单问题时，不要只依赖页面提交流程：直接在Django Shell中手动初始化表单实例，传入测试数据调用is_valid()，打印form.errors就能快速定位校验失败的原因，调试效率比反复提交页面高很多
• 新手阶段优先参考Django官方文档中关于ModelForm、通用视图（CreateView、FormView）的基础章节，所有示例都是可直接运行的最小实现，没有冗余的第三方封装，适合对照练习

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