Django中带user+date唯一约束的AssignedTip模型update_or_create报错解决

定义了如下AssignedTip模型，其中user与date字段设置了unique_together联合唯一约束：

class AssignedTip(models.Model):
    """Model representing a tip (but not a specific copy of a tip)."""
    user = models.ForeignKey(User, on_delete=models.CASCADE)
    date = models.DateField(null=True)
    note = models.CharField(max_length=50, default="Tip")
    amount = models.FloatField()
    minutes = models.FloatField(default=0)

    class Meta:
        unique_together = ('user', 'date',)

需求是向该表插入数据时，若匹配到user+date的唯一约束则更新现有对象，而非创建新对象。但使用以下update_or_create代码时出现报错：

AssignedTip.objects.update_or_create(user=User.objects.get(id=user), amount=user_amount, date=day.date(), minutes=minutes)

报错核心信息：

Exception Type: IntegrityError at /tasks/
Exception Value: UNIQUE constraint failed: tips_assignedtip.user_id, tips_assignedtip.date

update_or_create的参数需要严格分成两部分：

1. 查询匹配条件：放在defaults参数之外，用来定位唯一记录（必须是能确定唯一匹配的字段，这里就是联合唯一约束的user和date）
2. 更新字段：放在defaults字典中，查询到匹配记录时用这些值更新；未查询到则结合查询条件和defaults的值创建新记录

你的错误在于把所有字段都作为查询条件传入，这会导致：如果存在一条user+date匹配但amount或minutes不同的记录，update_or_create会尝试创建新记录，触发联合唯一约束报错。

正确代码示例：

# 先获取user实例（如果已经持有user对象，直接传入即可，无需重复查询）
user_obj = User.objects.get(id=user)
# 调用update_or_create
AssignedTip.objects.update_or_create(
    # 查询条件：仅使用联合唯一约束的字段
    user=user_obj,
    date=day.date(),
    # 更新字段：需要修改或设置的其他字段
    defaults={
        'amount': user_amount,
        'minutes': minutes,
        # 若需要更新note，可添加在此，否则保留原有值
        # 'note': 'Updated Tip'
    }
)

补充说明：

• 确保user参数传入的是User模型实例，而非id值（你的代码中User.objects.get(id=user)是正确的，但直接传入已持有的user实例更高效）
• 因为date允许为null，需注意数据库中null不视为相等的逻辑：两条user相同、date为null的记录会违反唯一约束，这是模型设计需要留意的点

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