Django表单POST提交后ImageField图片字段不更新问题求解

问题根因 #

你遇到的图片字段无法更新是视图中表单实例化时未传入上传文件对象导致的，同时还有几处隐含BUG也需要同步修复：

• 核心问题：Django 处理包含文件/图片的POST请求时，必须将request.FILES作为参数传入表单类，否则表单不会读取、处理上传的文件资源，这是image字段没有更新的直接原因
• 隐含问题1：redirect('busi:index')前没有加return，保存完成后不会正常跳转，会继续执行后续渲染逻辑
• 隐含问题2：GET请求初始化表单时没有传入instance=profile，用户进入编辑页时不会自动加载已有的旧数据，编辑体验异常

修复方案 #

替换视图代码为以下内容即可：

def profile(request):
    profile = Profile.objects.get(user=request.user)
    if request.method == 'POST':
        # 新增request.FILES参数，用来接收上传的图片
        form = ProfileForm(request.POST, request.FILES, instance=profile)
        if form.is_valid(): # 补充表单校验逻辑，避免脏数据写入
            profile = form.save(commit=False)
            profile.user = request.user
            profile.save()
            # 新增return，保证跳转正常执行
            return redirect('busi:index')
    else:
        # 新增instance参数，加载已有数据到表单
        form = ProfileForm(instance=profile)
    context = {
        'profile':profile,
        'form':form
    }

    return render(request , 'user/profile.html' , context)

额外排查项 #

如果修改后还是无法上传，检查以下配置：

1. 项目settings.py中是否配置了正确的媒体文件参数：

# 媒体文件存储根路径
MEDIA_ROOT = BASE_DIR / 'media'
# 媒体文件访问前缀
MEDIA_URL = '/media/'

2. 项目根urls.py中是否配置了媒体文件的访问路由（开发环境生效）：

from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    # 原有路由
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

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