Django文件上传至服务器后损坏问题求助

以下是针对Django admin上传文件后损坏问题的常见排查方向和解决办法：

• 检查自定义代码中的文件处理逻辑
  如果项目中存在自定义的ModelAdmin、模型save方法或者信号处理器，确认没有对上传文件做错误的文本编码处理。比如误用文本模式打开二进制文件会直接破坏文件内容：

  # 错误示例：用文本模式读取二进制文件
  with open(instance.source_file.path, 'r') as f:
      content = f.read()
  # 正确写法：使用二进制模式操作
  with open(instance.source_file.path, 'rb') as f:
      content = f.read()
  

• 验证文件系统权限与存储空间

  1. 确认MEDIA_ROOT对应的目录拥有服务器进程（如gunicorn、uwsgi、nginx）的读写权限，权限不足会导致文件写入不完整。
  2. 检查服务器磁盘空间是否充足，空间耗尽会造成文件仅部分写入就中断。

• 排查HTTP服务器配置
  如果使用nginx作为反向代理，确保client_max_body_size参数设置足够大，避免大文件被截断。示例配置：

  client_max_body_size 100M; # 根据实际文件大小调整数值
  

  同时检查是否有安全中间件、防火墙对上传文件进行了篡改或截断操作。

• 检查文件存储后端实现
  若使用了自定义文件存储后端（而非默认的FileSystemStorage），确认其_save方法正确处理二进制数据，没有在存储过程中修改文件内容。示例正确实现：

  def _save(self, name, content):
      content.open()
      with open(self.path(name), 'wb') as f:
          f.write(content.read())
      content.close()
      return name
  

• 区分本地与生产环境测试
  在本地开发环境（runserver）测试文件上传，若本地正常，说明问题出在生产环境的服务器配置、权限或存储后端；若本地也出现损坏，重点排查项目代码中的自定义逻辑。

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