Django实现可选图片上传：解决MultiValueDictKeyError问题

问题根源 #

你直接用request.FILES['pictures']取值时，会强制要求该字段必须存在。当用户不上传图片时，request.FILES字典里没有pictures这个键，就会触发MultiValueDictKeyError。

解决方案1：用request.FILES.get()安全取值 #

修改views.py中创建Notes实例的代码，用get方法获取图片，不存在时自动返回None：

def notes(request):
    if request.method == "POST":
        form = NotesForm(request.POST, request.FILES)
        if form.is_valid():
            # 用get方法安全获取图片，默认值为None
            pictures = request.FILES.get('pictures', None)
            notes = Notes(
                user=request.user,
                title=request.POST['title'],
                description=request.POST['description'],
                pictures=pictures
            )
            notes.save()
        messages.success(request, f"Notes added for {request.user.username} successfully!")
    else:
        form = NotesForm()
    notes = Notes.objects.filter(user=request.user)
    context = {'notes': notes, 'form': form}
    return render(request, 'dashboard/notes.html', context)

解决方案2：利用ModelForm的save方法（更推荐） #

如果你的NotesForm是ModelForm（推荐写法），直接用表单的save方法可以自动处理所有字段，包括可选的图片：

先确保forms.py中定义正确的ModelForm：

from django import forms
from .models import Notes

class NotesForm(forms.ModelForm):
    class Meta:
        model = Notes
        fields = ['title', 'description', 'pictures']

然后简化views.py的代码：

def notes(request):
    if request.method == "POST":
        # 传入user实例，避免手动赋值
        form = NotesForm(request.POST, request.FILES, instance=Notes(user=request.user))
        if form.is_valid():
            # 表单自动处理所有字段，包括可选的图片
            form.save()
        messages.success(request, f"Notes added for {request.user.username} successfully!")
    else:
        form = NotesForm()
    notes = Notes.objects.filter(user=request.user)
    context = {'notes': notes, 'form': form}
    return render(request, 'dashboard/notes.html', context)

额外注意 #

• 模板里的表单必须包含enctype="multipart/form-data"，比如：

<form method="post" enctype="multipart/form-data">
    {% csrf_token %}
    {{ form.as_p }}
    <button type="submit">提交</button>
</form>

• 你的models.py中pictures字段的null=True, blank=True设置是正确的，保持不变即可。

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