Django上传媒体文件触发MultiValueDictKeyError错误如何解决

问题原因及解决方法 #

1. 视图层逻辑错误（核心错误）

你当前views.py中的两处逻辑错误直接导致上传失败：

• 上传的媒体文件不会存在request.POST中，而是存储在request.FILES对象里，你手动写的data.media = request.POST['media']完全错误。
• 你使用的是绑定了request.POST和request.FILES的ModelForm，调用save方法时会自动处理媒体字段的存储，不需要手动赋值media字段。
• 你的Post模型中关联用户的外键字段名为member，不是user，赋值对象错误。

修改后的视图对应代码：

if form.is_valid() and request.POST['action']=='posting':
    data=form.save(commit=False)
    # 对应模型的外键字段名是member
    data.member = request.user
    # 删掉手动赋值data.media的代码
    data.save()
    print("posted status")
    return redirect("/home")

2. 模型字段配置缺失

你的Post模型的ImageField没有配置upload_to参数，Django无法确定文件上传后的存储子路径：
修改models.py中Post模型的media字段：

media = models.ImageField(upload_to='post_images/', blank=True, null=True)

修改完成后执行迁移命令生效：

python manage.py makemigrations
python manage.py migrate

3. 开发环境媒体路由未配置

你已经在settings.py中正确配置了MEDIA_ROOT和MEDIA_URL，但还需要在全局urls.py中添加开发环境的媒体资源路由，否则无法正常访问和存储媒体文件：
在全局urls.py中添加如下配置：

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

urlpatterns = [
    # 你原有所有路由配置保持不变
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

4. 基础环境检查

• 手动在项目根目录创建media文件夹，部分情况下Django不会自动生成该目录，权限不足时会导致写入失败。
• 确认你的运行环境已经安装了pillow库（Django处理图片字段的依赖），如果没有安装执行pip install pillow即可。

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