sorl-thumbnail使用convert引擎保存缩略图报错如何修复

核心报错根因 #

所有报错都是连锁触发的：

1. 最底层触发错误：sorl-thumbnail 的 convert 引擎存在 Windows 环境下的类导入错配
   引擎代码里错把 Django 自研的 django.core.files.temp.TemporaryFile 当成 Python 标准库的 tempfile.NamedTemporaryFile 使用。Django 自研的临时文件类不支持标准库的 delete 初始化参数，调用时直接抛出 __init__() got an unexpected keyword argument 'delete' 错误，临时文件对象初始化不完整，后续析构时就会出现找不到 close_called 属性的警告。
2. 连锁反应：因为临时文件创建失败，sorl 的缩略图生成流程直接中断，根本没有在 media/cache/ 目录下生成对应的缩略图文件，但 sorl 已经在数据库缓存里标记了这个缩略图的存在，后续调用 thumbnail.read() 时就会抛出 FileNotFoundError，提示找不到缓存路径下的文件。
3. 配置层面的兼容性问题：当前使用的 convert 引擎强依赖外部 ImageMagick 命令行，在 32位 Windows + 32位 Python 环境下兼容性差，且无法对非图片类文件生成有效缩略图。

可落地的解决方案 #

• 替换兼容性更好的缩略图引擎
  放弃对外部命令依赖较高的 convert 引擎，改用 sorl 内置的 PIL 引擎，从根源避免 Windows 下的临时文件类兼容问题：

  # settings.py 替换原配置
  THUMBNAIL_ENGINE = 'sorl.thumbnail.engines.pil_engine.Engine'
  

  安装兼容版本的 Pillow 依赖，和 32位 Python 环境匹配。
• 修正 save 方法的逻辑，适配任意文件类型的上传场景
  原逻辑缺少对非图片文件的异常捕获，且直接引用 sorl 缓存文件的方式存在缓存被误删的风险，修正后的代码如下：

  from django.core.files.base import ContentFile
  def save(self, *args, **kwargs):
      if self._state.adding:
          self.size = self.file.size
          # 先完成原文件的数据库写入和存储
          super().save(*args, **kwargs)
          # 仅对可解码的图片文件生成缩略图，非图片文件跳过不阻塞流程
          try:
              # 生成1280x720 居中裁剪的缩略图
              thumb = get_thumbnail(self.file, '1280x720', crop='center')
              # 读取缩略图文件流，不依赖sorl的缓存路径
              thumb_stream = thumb.read()
              # 转存到自定义的thumbnail字段指定路径下
              self.thumbnail.save(
                  name=f'thumb_{self.file.name.split("/")[-1]}',
                  content=ContentFile(thumb_stream),
                  save=False
              )
              # 单独更新缩略图字段到数据库
              self.save(update_fields=['thumbnail'])
          except Exception:
              # 遇到非图片文件、图片解码失败时，保持thumbnail字段为null即可
              pass
          return
      super().save(*args, **kwargs)
  

• 清理无效的 sorl 缓存
  执行 sorl 自带的缓存清理命令，删除之前生成失败的残留缓存记录和文件：

  python manage.py thumbnail cleanup
  

• 可选：如果必须保留 convert 引擎
  手动修正 sorl 的导入bug：打开虚拟环境下的 sorl/thumbnail/engines/convert_engine.py 文件，将开头的导入语句从导入 Django 临时文件类，替换为导入 Python 标准库的临时文件类：

  # 原错误导入
  # from django.core.files.temp import NamedTemporaryFile
  # 修正为
  import tempfile
  NamedTemporaryFile = tempfile.NamedTemporaryFile
  

  同时在 settings.py 中指定本地 ImageMagick 可执行文件的绝对路径，确保 Windows 下能正确调用命令行工具：

  THUMBNAIL_CONVERT = 'C:\\Program Files (x86)\\ImageMagick-7.0.10-61-Q16\\convert.exe'
  

  路径替换为本地实际的安装位置即可。

注意事项 #

• 因为 file 字段支持任意类型文件，必须保留生成缩略图环节的异常捕获逻辑，避免遇到压缩包、视频、文档等非图片文件时触发解码错误，阻塞整个上传流程。
• 不要直接把 sorl 缓存目录下的文件路径绑定到 thumbnail 字段，否则 sorl 定期清理缓存时会误删已经持久化存储的缩略图文件。

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