在django项目中，当开发者使用自定义用户模型（继承自abstractuser）并尝试通过updateview来更新用户资料时，可能会遇到一个看似奇怪的现象：用户在前端页面提交表单后，页面会重新加载，并且表单中显示的数据似乎是更新过的。然而，一旦刷新页面或重新访问，数据库中的数据并未发生实际改变。这通常表明表单验证失败，导致数据未能保存。
问题场景复现
假设我们有一个自定义的User模型，其中包含nickname等额外字段，并使用UpdateView和UserChangeForm进行更新。
models.py
import uuid
from django.contrib.auth.models import AbstractUser, UserManager as BaseUserManager
from django.db import models
class UserManager(BaseUserManager):
def New_Requests(self):
return self.filter(is_seller="I")
class User(AbstractUser):
nickname = models.CharField(max_length=50, verbose_name="昵称", default='User')
is_seller_status = (
('N','未接受'),
('I','审核中'),
('A','已接受')
)
is_seller = models.CharField(default='N', max_length=1, choices=is_seller_status, verbose_name='商家状态')
user_id = models.UUIDField(default=uuid.uuid4, editable=False, unique=True)
profile = models.ImageField(upload_to="user_profile", blank=True, null=True, verbose_name='头像')
admin_reject_reason = models.TextField(default='暂未审核', verbose_name='管理员拒绝原因')
objects = UserManager() # 关联自定义的Managerforms.py
from django.contrib.auth.forms import UserChangeForm
from .models import User
class UserProfileForm(UserChangeForm):
def __init__(self, *args, **kwargs):
user = kwargs.pop('user')
super().__init__(*args, **kwargs)
# 非超级用户禁用部分字段
if not user.is_superuser:
self.fields['first_name'].disabled = True
self.fields['last_name'].disabled = True
self.fields['email'].disabled = True
self.fields['is_seller'].disabled = True
class Meta:
model = User
fields = ['profile', 'nickname', 'username', 'email', 'first_name', 'last_name', 'is_seller']views.py
from django.contrib.auth.mixins import LoginRequiredMixin
from django.urls import reverse_lazy
from django.views.generic import UpdateView
from .forms import UserProfileForm
from .models import User
class AccountView(LoginRequiredMixin, UpdateView):
model = User
form_class = UserProfileForm
template_name = "user/profile.html"
success_url = reverse_lazy("user:profile")
def get_object(self):
return User.objects.get(pk=self.request.user.pk)
def get_form_kwargs(self):
kwargs = super().get_form_kwargs()
kwargs['user'] = self.request.user
return kwargsprofile.html (部分关键代码)
<form method="post" enctype="multipart/form-data">{% csrf_token %}
<div class="row">
<div class="col-6">
{{ form.username|as_crispy_field }}
</div>
<div class="col-6">
{{ form.email|as_crispy_field }}
</div>
<div class="col-6">
{{ form.first_name|as_crispy_field }}
</div>
<div class="col-6">
{{ form.last_name|as_crispy_field }}
</div>
<div class="col-6">
{{ form.is_seller|as_crispy_field }}
</div>
<div class="col-6">
{{ form.profile|as_crispy_field }}
</div>
</div>
<input class="btn btn-success" type="submit" value="更新">
</form>在上述配置中，用户点击“更新”按钮后，页面重载，但数据库中的数据并未改变。
这个问题的根源在于Django的表单验证机制。当使用UpdateView提交表单时，Django会尝试验证提交的数据。如果表单验证失败，UpdateView默认不会保存数据，而是重新渲染页面，并可能显示错误信息（如果模板配置了错误显示）。
结合上述代码，问题出在nickname字段上：
结论： 当用户提交表单时，因为模板中没有渲染nickname字段，所以提交的数据中不包含nickname的值。而UserProfileForm在验证时发现nickname是必填项但值为空，因此表单验证失败。UpdateView接收到无效表单后，不会执行保存操作，仅仅是重新渲染了带有原始数据的表单（因为数据没有保存到数据库）。
针对上述问题，有以下三种主要的解决方案，开发者应根据实际业务需求选择最合适的一种：
如果nickname字段并非必须由用户在每次更新时都提供，或者允许为空，那么最直接的方法是在模型定义中将其设置为可选。
修改 models.py：
悟空CRM是一种客户关系管理系统软件.它适应Windows、linux等多种操作系统，支持Apache、Nginx、IIs多种服务器软件。悟空CRM致力于为促进中小企业的发展做出更好更实用的软件，采用免费开源的方式，分享技术与经验。 悟空CRM 0.5.5 更新日志：2017-04-21 1.修复了几处安全隐患； 2.解决了任务.日程描述显示问题； 3.自定义字段添加时自动生成字段名
284
class User(AbstractUser):
nickname = models.CharField(max_length=50, verbose_name="昵称", default='User', blank=True) # 添加 blank=True
# ... 其他字段保持不变说明：
如果nickname字段是用户需要编辑的重要信息，那么应该在模板中将其渲染出来，确保用户能够输入并提交该字段的值。
修改 profile.html： 在表单的适当位置添加nickname字段的渲染。
<form method="post" enctype="multipart/form-data">{% csrf_token %}
<div class="row">
<!-- ... 其他字段 ... -->
<div class="col-6">
{{ form.nickname|as_crispy_field }} {# 添加这一行 #}
</div>
<div class="col-6">
{{ form.profile|as_crispy_field }}
</div>
</div>
<input class="btn btn-success" type="submit" value="更新">
</form>说明：
如果nickname字段不需要通过此特定的用户资料更新表单进行编辑，那么最简单的做法就是将其从UserProfileForm的Meta.fields中移除。
修改 forms.py：
class UserProfileForm(UserChangeForm):
# ... __init__ 方法保持不变
class Meta:
model = User
fields = ['profile', 'username', 'email', 'first_name', 'last_name', 'is_seller'] # 移除 'nickname'说明：
在遇到类似问题时，以下调试技巧可以帮助快速定位问题：
重写 form_invalid 方法： 在UpdateView中重写form_invalid方法，并打印form.errors，可以清晰地看到表单验证失败的具体原因。
修改 views.py：
class AccountView(LoginRequiredMixin, UpdateView):
# ... 其他属性和方法
def form_invalid(self, form):
print("表单验证失败，错误信息：", form.errors)
return super().form_invalid(form)提交表单后，查看服务器控制台输出，通常会显示类似 {'nickname': ['This field is required.']} 的错误信息，从而明确指出是哪个字段导致了验证失败。
在模板中显示表单错误： 虽然crispy_forms通常会自动显示字段错误，但为了确保，可以在模板中显式地显示非字段错误或表单整体错误。
<form method="post" enctype="multipart/form-data">{% csrf_token %}
{% if form.errors %}
<div class="alert alert-danger">
<strong>请检查以下错误：</strong>
<ul>
{% for field, errors in form.errors.items %}
{% if field == '__all__' %}
<li>{{ errors }}</li>
{% else %}
<li>{{ field }}: {{ errors|join:", " }}</li>
{% endif %}
{% endfor %}
</ul>
</div>
{% endif %}
<!-- ... 表单字段 ... -->
</form>Django UpdateView更新自定义用户模型数据不持久化的问题，通常是由于表单验证失败所致。核心原因在于模型中定义的必填字段，在表单中被包含，但在模板中却未被渲染，导致提交时该字段值缺失。通过将模型字段设置为可选、在模板中渲染缺失字段或从表单中移除不必要的字段，可以有效解决此问题。同时，利用form_invalid方法和浏览器开发者工具进行调试，是快速定位和解决此类问题的关键。理解Django的表单验证机制和模型字段属性（如blank和null），对于开发健壮的Django应用至关重要。
以上就是解决Django自定义用户模型UpdateView更新失败的问题的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
518
收藏
