Django重写ModelForm.save后自定义用户保存失败、多对多关联丢失问题

• Form实例被错误覆盖
  编辑已有用户场景下，ModelForm初始化时已经绑定了数据库中对应带主键的User实例，但save方法中直接通过新提交的邮箱查询实例/新建实例，替换了原有绑定的实例。修改邮箱时，新提交的邮箱未在数据库中存在，会直接新建实例；即使邮箱未修改，替换实例的操作也会破坏Django Admin依赖的实例状态校验，最终触发无明确字段提示的通用报错。
• 多对多关联逻辑被破坏
  多对多字段的保存依赖ModelForm绑定的原有实例，替换实例后，_save_m2m()方法会将关联数据写入新实例而非原编辑的实例。且自定义Form的Meta.fields未包含permission_set等多对多字段，同时Django Admin的内联表单保存依赖主Form返回实例的主键与原编辑实例一致，主键不匹配时内联的权限关联不会被保存，最终导致关联关系被清空。
• Save方法重写逻辑冗余
  不需要完全重写save方法处理密码加密，该逻辑可以移动到clean_password表单钩子中实现，原生ModelForm的save逻辑已经兼容了Django Admin的实例校验、多对多关联保存等逻辑，完全重写后破坏了原有兼容逻辑。

from django.contrib.auth.forms import UserChangeForm
from django.contrib.auth.hashers import make_password

# 推荐直接继承Django自带的UserChangeForm，避免重复实现密码处理等原生逻辑
class CustomUserAdminForm(UserChangeForm):
    class Meta:
        model = User
        fields = [
            "email",
            "password",
            "is_admin"
        ]
    
    def clean_password(self):
        password = self.cleaned_data["password"]
        # 仅当输入为明文密码时做加密处理
        if not password.startswith("pbkdf2_sha256$"):
            return make_password(password)
        return password

• 如果使用Admin内联表单管理权限关联，不需要在主Form中添加多对多字段，只要不修改主Form绑定的原有实例即可正常保存内联关联。
• 不要在save方法中替换self.instance，原有原生逻辑会自动处理实例的更新。

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