使用Objects.create()时Django触发唯一约束重复键值错误

核心原因 #

你遇到的问题大概率是因为objects.create()内部会带着force_insert=True参数调用save()方法，而你的重写逻辑里两次调用super().save(*args, **kwargs)时，第二次依然传递了这个参数——当第一次保存已经生成主键后，force_insert=True会强制Django执行插入操作而非更新，自然就触发了主键重复的约束错误。

而Django admin页面的保存流程不一样：通过ModelForm添加对象时，会先调用save(commit=False)生成实例但不插入数据库，后续真正保存时不会传递force_insert=True，所以第二次super().save()会正常执行更新操作，不会报错。

解决方法 #

修改你的save()方法，在第二次保存时移除force_insert参数，或者根据主键是否存在来控制保存行为：

def save(self, *args, **kwargs):
    # 先取出force_insert参数，避免后续强制插入
    force_insert = kwargs.pop('force_insert', False)
    
    if not self.pk:
        # 第一次保存生成主键，这里可以传递原force_insert
        super().save(*args, **kwargs, force_insert=force_insert)
    
    # 这里写你修改filename的逻辑，比如结合user或pk生成新文件名
    self.filename = f"{self.user.id}_{self.filename}"
    
    # 第二次保存：如果已有主键，强制执行更新操作
    super().save(*args, **kwargs, force_update=self.pk is not None)

或者更简洁的方式，在第二次保存时直接排除force_insert：

def save(self, *args, **kwargs):
    if not self.pk:
        # 第一次保存，先获取主键
        super().save(*args, **kwargs)
    
    # 修改filename逻辑
    self.filename = ...
    
    # 第二次保存，移除force_insert参数
    kwargs.pop('force_insert', None)
    super().save(*args, **kwargs)

额外建议 #

如果你的filename修改逻辑依赖主键，其实可以考虑用数据库的默认值或者信号来实现，避免两次调用save()：

• 比如用post_save信号，在对象创建完成后修改filename并保存（注意要加判断避免递归调用）
• 或者如果使用PostgreSQL，可以用DEFAULT结合函数生成包含主键的文件名（不过这种方式不够灵活）

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