Django操作SQL Server复合主键表时更新数据触发主键重复约束错误的问题求助

我之前处理过类似的遗留数据库适配问题，核心矛盾确实是Django原生不支持复合主键，但我们完全可以通过调整模型和序列化器逻辑来绕过这个限制，无需修改现有数据库结构。让我们一步步解决：

问题根源分析 #

你当前的模型存在两个关键问题：

1. 错误使用了OneToOneField：数据库中一个LocationID对应多个Setting记录，属于一对多关系，而非一对一，这会导致Django ORM对主键的逻辑判断混乱。
2. 强行将location_id设为主键：这让Django误以为location_id是唯一主键，忽略了数据库中LocationID+Setting的复合主键约束，最终在更新时触发插入重复键的错误。

解决方案（无需修改数据库） #

1. 修正模型定义 #

我们需要添加一个虚拟主键字段（仅满足Django ORM的主键要求，不映射到数据库），同时修正关联字段类型：

class SystemDatetimeSettings(models.Model):
    # 虚拟主键：数据库中不存在该字段，仅用于满足Django ORM的主键要求
    id = models.IntegerField(primary_key=True)
    # 改为ForeignKey，匹配数据库一对多的实际关系
    location_id = models.ForeignKey(Locations, models.DO_NOTHING, db_column='LocationID')
    setting = models.CharField(db_column='Setting', max_length=50)
    value = models.DateTimeField(db_column='Value', blank=True, null=True)

    def get_api_url(self, request=None):
        return reverse("api:datetime-settings-update", kwargs={
            'location_id': int(self.location_id.location_id),
            'setting': self.setting
        }, request=request)

    class Meta:
        managed = False
        db_table = 'SystemDateTimeSettings'
        # 保留复合唯一约束，与数据库一致
        unique_together = (('location_id', 'setting'),)
        # 添加复合索引提升查询性能
        indexes = [
            models.Index(fields=['location_id', 'setting']),
        ]

2. 重写序列化器的更新逻辑 #

明确指定仅更新value字段，避免Django生成不必要的SQL操作：

class SystemDatetimeSettingsSerializer(serializers.ModelSerializer):
    url = serializers.SerializerMethodField(read_only=True)

    class Meta:
        model = SystemDatetimeSettings
        fields = ['url', 'location_id', 'setting', 'value']
        read_only_fields = ['location_id', 'setting']

    def get_url(self, obj):
        request = self.context.get("request")
        return obj.get_api_url(request=request)

    def update(self, instance, validated_data):
        # 仅更新value字段，避免触碰主键相关字段
        if 'value' in validated_data:
            instance.value = validated_data['value']
        # 指定update_fields确保生成的SQL仅更新value，防止触发插入逻辑
        instance.save(update_fields=['value'])
        return instance

3. 视图代码保持不变 #

你的DatetimeSettingsUpdate视图已经正确通过location_id和setting组合查询实例，无需修改：

class DatetimeSettingsUpdate(RetrieveUpdateAPIView):
    lookup_field = 'setting'
    serializer_class = SystemDatetimeSettingsSerializer
    permission_classes = [permissions.IsAuthenticated]

    def get_object(self):
        location_id = self.kwargs.get('location_id')
        setting = self.kwargs.get('setting')
        return get_object_or_404(SystemDatetimeSettings, location_id=location_id, setting=setting)

为什么这样能解决问题？ #

• 虚拟主键字段满足了Django ORM必须有单一主键的硬性要求，同时不会对现有数据库结构产生任何影响。
• 修正为ForeignKey后，ORM逻辑与数据库的一对多关系匹配，避免了主键判断混乱。
• 重写update方法并指定update_fields，确保Django生成的SQL是精准的UPDATE语句（仅修改value），彻底避免了触发插入重复键的逻辑。

你可以开启Django的DEBUG模式查看SQL日志，验证更新操作生成的是UPDATE dbo.SystemDateTimeSettings SET Value = ... WHERE LocationID = ? AND Setting = ?这样的语句，而非插入语句。

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