Django 表单上传图片未存入数据库与media/student_img目录的问题

1. 前端表单缺失文件上传必备编码属性（最高发问题） #

• 直接原因：没有在文件上传的<form>标签上设置enctype="multipart/form-data"时，浏览器会默认用application/x-www-form-urlencoded编码发送请求，二进制文件内容完全不会上传到后端，request.FILES会始终为空字典
• 对应表现：视图中取到的photo值为None，模型保存时只会在数据库写入空的photo路径，磁盘上完全不会生成对应文件
• 修正方法：
  1. 给表单补充enctype属性
  2. 补上跨站请求伪造校验标签{% csrf_token %}，否则POST请求会被Django的中间件直接拦截，根本不会执行视图内的保存逻辑
     示例表单结构：

  <form method="POST" enctype="multipart/form-data">
      {% csrf_token %}
      <div class="form-group col-sm-6">
          <label for="exampleFormControlFile1">Photos of Student</label>
          <input type="file" class="form-control-file" id="exampleFormControlFile1" name="photo">
      </div>
      <button type="submit" class="btn btn-primary">提交</button>
  </form>
  

2. 缺少ImageField依赖库 #

• 直接原因：Django的ImageField必须依赖Pillow库才能完成图片格式校验、文件流解析、磁盘写入的全流程，没装的话保存逻辑会直接抛出报错中断
• 对应表现：开启调试模式能看到明确的依赖缺失报错，生产环境下会静默返回500错误，没有任何数据落盘或入库
• 修正方法：
  安装匹配Django版本的Pillow依赖：

  pip install pillow
  

3. 媒体存储根目录路径配置偏差 #

• 直接原因：当前settings中的MEDIA_ROOT是基于BASE_DIR的上级目录拼接的，和你预期的“项目内media文件夹存储图片”的路径不匹配
• 对应表现：就算上传流程正常，文件会被写到项目根目录外层的media文件夹下，你在项目内的media/student_img目录下完全找不到文件
• 修正方法：
  调整MEDIA_ROOT的拼接逻辑，直接指向项目根目录下的media文件夹，和模型中定义的upload_to='student_img/'形成完整路径映射（即最终存储路径为MEDIA_ROOT/student_img/文件名）：

  MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
  MEDIA_URL = '/media/'
  

4. 视图逻辑无校验导致静默失败 #

• 直接原因：Django模型的save()方法默认不会触发模型字段的合法性校验，一旦上传流程中断、取到的photo值为空，代码会直接走完保存流程，既不抛明显错误，也不会生成有效数据
• 对应表现：页面提交后没有任何报错提示，数据库里新增了一条Student记录，但photo字段是空字符串，磁盘上没有对应图片
• 修正方法：
  在保存前补充取值校验和模型全量校验，把异常显式暴露出来：

  if request.method == 'POST':
      photo = request.FILES.get('photo')
      # 校验是否取到上传文件
      if not photo:
          return render(request, 'student_form.html', {'error': '请选择需要上传的学生图片'})
      student = Student(photo=photo)
      # 触发模型字段校验，不合法数据会抛出明确错误
      student.full_clean()
      student.save()
  

5. 开发环境下媒体文件路由缺失 #

• 直接原因：Django内置的开发服务器默认只托管静态文件，不会自动对外暴露MEDIA_ROOT路径下的上传文件
• 对应表现：文件已经成功写入磁盘、数据库也存了正确的图片路径，但前端访问图片时返回404
• 修正方法：
  在项目根路由文件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，提问作者Arka Palit