Django Admin批量上传文件触发400错误，需导入Zip图片与Excel关联数据

我来帮你排查这个Django Admin里多文件上传的400错误问题，结合你给出的admin.py代码片段，大概率是下面几个常见原因导致的，咱们一个个来解决：

1. CSRF令牌没处理好 #

Django Admin默认依赖CSRF保护，你自定义的import-images视图如果没做CSRF验证，直接就会返回400错误。

• 解决办法：
  给你的自定义上传视图加上@csrf_protect装饰器，或者用Admin自带的admin_view包装视图（它会自动处理CSRF和权限）。示例代码：

  from django.views.decorators.csrf import csrf_protect
  from django.contrib import messages
  
  @csrf_protect
  def import_images_view(self, request):
      if request.method == 'POST':
          # 处理上传逻辑
          pass
      # 返回模板
      return render(request, 'entities/images_changelist.html', {'opts': self.model._meta})
  
  # 或者在get_urls里用admin_view包装
  def get_urls(self):
      from django.urls import path
      urls = super().get_urls()
      my_urls = [
          path('import-images/', self.admin_site.admin_view(self.import_images_view), name='import-images'),
      ]
      return my_urls + urls
  

  另外，你的上传模板entities/images_changelist.html里的表单必须加上{% csrf_token %}：

  <form method="post" enctype="multipart/form-data">
      {% csrf_token %}
      <input type="file" name="zip_images" accept=".zip">
      <input type="file" name="xlsx_data" accept=".xlsx">
      <button type="submit">批量导入</button>
  </form>
  

2. 表单没设置正确的enctype #

多文件上传的表单必须指定enctype="multipart/form-data"，否则Django根本解析不了上传的文件，直接返回400。

• 检查你的模板表单，务必包含这个属性，就像上面示例里那样。

3. 文件大小超过限制 #

Django默认有文件上传大小限制（FILE_UPLOAD_MAX_MEMORY_SIZE默认是2.5MB），如果你的ZIP或XLSX文件太大，就会触发400错误。另外服务器（比如Nginx）也可能有自己的大小限制。

• 解决办法：
  在settings.py里调整配置：

  # 允许最大50MB的内存内上传
  FILE_UPLOAD_MAX_MEMORY_SIZE = 52428800
  # 超大文件会存在临时目录，可指定路径
  FILE_UPLOAD_TEMP_DIR = '/tmp/django_uploads'
  

  如果用Nginx，修改配置文件中的client_max_body_size为100M左右，然后重启Nginx生效。

4. 自定义视图的请求处理逻辑有问题 #

比如你在处理POST请求时，没有正确获取上传的文件，或者字段名称不匹配，也会导致400。

• 示例正确的文件获取和验证逻辑：

  def import_images_view(self, request):
      if request.method == 'POST':
          zip_file = request.FILES.get('zip_images')
          xlsx_file = request.FILES.get('xlsx_data')
          
          # 先验证文件有效性
          if not zip_file or not zip_file.name.endswith('.zip'):
              self.message_user(request, '请上传有效的ZIP图片包！', level=messages.ERROR)
              return redirect('admin:entities_imagemodel_changelist')
          if not xlsx_file or not xlsx_file.name.endswith('.xlsx'):
              self.message_user(request, '请上传有效的XLSX关联数据文件！', level=messages.ERROR)
              return redirect('admin:entities_imagemodel_changelist')
          
          # 这里写解压ZIP、读取XLSX、关联数据到ImageModel的逻辑
          # ...
          
          self.message_user(request, '批量导入成功！')
          return redirect('admin:entities_imagemodel_changelist')
      
      # GET请求返回上传页面
      return render(request, 'entities/images_changelist.html', {'opts': self.model._meta})
  

调试小技巧 #

如果还是找不到问题，打开Django的调试模式（DEBUG = True），此时400错误页面会显示详细的错误原因，比如“CSRF验证失败”“字段缺失”等，直接照着提示改就行。

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