Django表单更新时self.instance.pk为None的问题排查求助

你的问题核心出在视图函数的POST请求处理环节——当提交表单时，你没有把当前用户的instance传递给UserForm，导致表单默认认为这是一次新建用户的操作，而非更新现有记录，所以self.instance.pk始终为None。

另外，你的clean_username方法还有个隐藏bug：用get()查询用户时，如果找不到匹配项会直接抛出DoesNotExist异常，而非返回None，这会导致验证逻辑直接崩溃。

1. 修正views.py中的POST处理逻辑 #

在POST请求创建表单时，必须传入当前用户的instance，明确告诉表单这是更新操作：

def edit_profile(request):
    user_obj = request.user
    if request.method == "POST":
        # 关键：传入instance参数，绑定当前用户记录
        form = UserForm(request.POST, instance=user_obj)
        if form.is_valid():
            form.save()
            # 建议添加重定向，避免表单重复提交
            # return redirect('edit_profile')
    else:
        # GET请求时初始化绑定用户的表单
        form = UserForm(instance=user_obj)
    
    context = {"form": form}
    return render(request, "account/profile.html", context)

2. 优化forms.py中的clean_username方法 #

调整查询逻辑，避免get()的异常，同时兼容新建用户（此时self.instance.pk为None）的场景：

from django import forms
from .models import CustomUser

class UserForm(forms.ModelForm):
    password = forms.CharField(label='Password', widget=forms.PasswordInput)
    password2 = forms.CharField(label='Password confirmation', widget=forms.PasswordInput)
    
    class Meta:
        model = CustomUser
        fields = '__all__'
        exclude = ["is_admin", "is_verified", "last_login"]

    def clean_username(self):
        username = self.cleaned_data.get("username")
        # 先筛选出所有同名用户
        queryset = CustomUser.objects.filter(username=username)
        # 如果是更新操作，排除当前实例
        if self.instance.pk is not None:
            queryset = queryset.exclude(pk=self.instance.pk)
        
        # 检查是否存在重复
        if queryset.exists():
            raise forms.ValidationError("Username already exists")
        return username

你的表单里有密码确认字段，但目前没有验证逻辑，建议补充一个全局clean方法：

def clean(self):
    cleaned_data = super().clean()
    password = cleaned_data.get("password")
    password2 = cleaned_data.get("password2")

    if password and password2 and password != password2:
        raise forms.ValidationError("Passwords do not match")
    return cleaned_data

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