Django admin多数据库上传图片至Cloudinary产生重复文件如何解决

Cloudinary默认的资源命名逻辑不会基于文件内容生成唯一标识，默认生成的存储文件名（public_id）是拼接上传时间、随机字符串生成的。不同环境、不同时间上传完全相同的图片时，因为时间戳、随机值不一致，会生成完全不同的public_id，Cloudinary会判定为全新资源单独存储，最终产生重复文件。
你当前的字段配置既没有指定基于文件内容的固定命名规则，也没有开启Cloudinary的重复检测能力，是问题出现的直接原因。

• 优先使用Cloudinary官方提供的模型字段替换Django原生ImageField，从字段层面接管上传命名逻辑
  首先引入依赖，自定义基于文件内容哈希的public_id生成方法，保证同一张图片无论在哪个环境上传，生成的存储路径完全一致：

  from cloudinary.models import CloudinaryField
  import hashlib
  
  def generate_content_hash_filename(instance, filename):
      # 读取文件内容生成MD5哈希，作为唯一文件名
      avatar_file = instance.avatar
      # 重置文件指针，避免读取时出现内容为空的问题
      if hasattr(avatar_file, 'seek'):
          avatar_file.seek(0)
      content_hash = hashlib.md5(avatar_file.read()).hexdigest()
      # 返回固定路径格式：avatar/[文件哈希值]
      return f"avatar/{content_hash}"
  
  # 替换原模型中的avatar字段
  avatar = CloudinaryField(
      'avatar',
      public_id=generate_content_hash_filename,
      default='avatar/default.png',
      blank=True,
      overwrite=True,
      # 关闭Cloudinary自动生成随机后缀的逻辑
      unique_filename=False,
      use_filename=False
  )
  

• 全局配置关闭重复上传权限
  在项目settings.py的Cloudinary配置项中添加参数，开启内容去重兜底，覆盖所有上传入口：

  CLOUDINARY = {
      'cloud_name': '替换为你的Cloudinary cloud_name',
      'api_key': '替换为你的API Key',
      'api_secret': '替换为你的API Secret',
      # 禁止同内容文件重复存储
      'allow_duplicates': False
  }
  

• 执行数据库迁移
  字段修改完成后，依次执行以下命令完成模型变更：

  python manage.py makemigrations
  python manage.py migrate
  

如果你不想替换现有ImageField，继续使用Django原生ImageField对接CloudinaryStorage后端，逻辑完全一致：自定义upload_to方法返回基于文件内容哈希的存储路径，同时给存储后端配置allow_duplicates=False参数，同样可以实现同图不重复存储的效果。
配置生效后，后续上传相同内容的图片时，Cloudinary会直接返回已存在的资源地址，不会生成新的重复文件。

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