Django用户更新表单可修改用户名邮箱但头像图片无法更新问题

问题原因 #

• 前端表单缺少文件上传必需的编码属性，浏览器不会提交上传的图片文件
• signals.py 代码存在语法错误，且信号逻辑会覆盖你提交的新头像数据

具体修复步骤 #

1. 修复HTML模板的表单标签，添加enctype属性，修改后代码如下：

<div>
    {{ user.username }}
    <img src="{{ user.profile.user_image.url }}">
    <a href="{% url 'delete-page' pk=user.id %}">Delete</a>
    <!-- 新增enctype属性支持文件上传 -->
    <form method="POST" enctype="multipart/form-data"> {% csrf_token %}
        {{ p_form.as_p}}
        {{ u_form.username }}
        {{ u_form.email }}
        <button type="submit">Update</button>
    </form>
</div>

2. 修复signals.py代码，删掉错误混入的模板代码，且移除多余的Profile自动保存逻辑，避免覆盖视图中已经保存的新头像，修改后代码如下：

@receiver(post_save, sender=User)
def profile_creation(sender, instance, created, **kwargs):
    if created:
        Profile.objects.create(user=instance)

# 直接删除下面这个save_profile信号即可，你在视图中已经手动调用p_form.save()保存Profile，这个信号多余且会导致旧数据覆盖新上传的头像
# @receiver(post_save, sender=User)
# def save_profile(sender, instance, **kwargs):
#         instance.profile.save()

3. 额外确认项：检查settings.py中是否正确配置了MEDIA_ROOT和MEDIA_URL，开发环境的根路由中是否添加了MEDIA资源的访问路由，保证上传的图片可以正常读取。

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