Django ModelForm重写save()方法时self.instance异常变更问题

针对你遇到的这个问题——表单clean阶段username还正常，但调用save()时self.instance.username突然变更，我来帮你梳理可能的原因和排查方案：

核心排查方向 #

1. 检查UserForm重写的save()方法 #

这是最常见的原因：你或者团队成员在重写save()方法时，不小心加入了修改username的逻辑，比如：

def save(self, commit=True):
    # 可能是复制代码遗留、逻辑判断错误导致的赋值
    self.instance.username = self.cleaned_data.get('email')  # 举个错误例子
    instance = super().save(commit=False)
    # 其他代码
    if commit:
        instance.save()
    return instance

你可以直接在save()方法的第一行打印self.instance.username，对比进入方法时和执行完自定义逻辑后的变化，定位问题代码。

2. 确认request.POST中是否意外携带了username参数 #

有时候前端表单可能不小心保留了username的输入框（哪怕是隐藏字段），或者提交时附带了这个参数，而你的UserForm虽然没在Meta.fields里声明username，但如果在save()方法里直接从self.data取了这个值赋值给instance，就会导致clean阶段没处理，但save时被修改：

def save(self, commit=True):
    # 错误示例：直接从POST数据取username赋值
    self.instance.username = self.data.get('username')
    return super().save(commit=commit)

先打印request.POST的内容，确认是否存在username键值对。

3. 排查User模型的信号处理器 #

Django的pre_save、post_clean信号可能会在表单clean完成后、save执行前修改User实例。比如注册了这样的信号：

from django.db.models.signals import pre_save
from django.dispatch import receiver
from django.contrib.auth.models import User

@receiver(pre_save, sender=User)
def auto_update_username(sender, instance, **kwargs):
    # 这里的逻辑可能误修改了username
    instance.username = instance.email.split('@')[0]

你可以临时注释掉这类信号，测试save时username是否还会变更，来验证是否是信号导致的问题。

快速验证步骤 #

在表单的关键方法里加打印，追踪username的变化时机：

class UserForm(forms.ModelForm):
    # 你的字段定义...

    def clean_username(self):
        current_username = self.instance.username
        print(f"clean_username阶段：{current_username}")
        return self.cleaned_data.get('username', current_username)

    def clean(self):
        cleaned_data = super().clean()
        print(f"clean阶段：{self.instance.username}")
        return cleaned_data

    def save(self, commit=True):
        print(f"进入save方法时：{self.instance.username}")
        # 执行原save逻辑
        instance = super().save(commit=commit)
        print(f"save完成后：{instance.username}")
        return instance

通过这些打印信息，你能精准定位username是在哪一步被修改的。

解决方案 #

• 如果是save()方法里的错误赋值：删除或修正相关逻辑，只保留必要的save处理。
• 如果是前端意外提交了username参数：要么移除前端的username字段，要么在表单的clean()方法里过滤掉这个参数，确保cleaned_data里不包含username（如果不需要修改它的话）。
• 如果是信号导致的：修改信号处理器，添加判断条件（比如只在特定场景下修改username），或者调整信号触发的时机。

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