Django中MySQL复合主键场景下.validate_unique()与.save()异常排查

1. 修正模型定义（核心） #

首先检查你的Athlete模型，不要将单个字段设为primary_key=True——这是导致仅Fname重复就触发主键错误的直接原因。Django不支持原生复合主键，但可以通过UniqueConstraint（Django 3.2+推荐）或unique_together定义复合唯一约束，同时保留Django默认的自增id主键（如果数据库表允许）。

示例模型：

from django.db import models

class Athlete(models.Model):
    fname = models.CharField(max_length=100, db_column='Fname')
    lname = models.CharField(max_length=100, db_column='Lname')
    dob = models.DateField(db_column='DOB')

    class Meta:
        db_table = 'Athlete_T'  # 对应数据库表名
        # 定义复合唯一约束，替代数据库的复合主键逻辑
        constraints = [
            models.UniqueConstraint(
                fields=['fname', 'lname', 'dob'],
                name='athlete_compound_unique'
            )
        ]
        # 若使用Django旧版本，改用unique_together：
        # unique_together = (('fname', 'lname', 'dob'),)
        
        # 如果是手动创建的数据库表（非Django迁移生成），添加以下配置
        # managed = False

2. 修复数据库表结构 #

确认你的MySQL表Athlete_T的主键是复合主键(Fname, Lname, DOB)，而非仅Fname作为主键。可以通过以下SQL检查：

-- 查看表主键字段
SELECT COLUMN_NAME 
FROM INFORMATION_SCHEMA.KEY_COLUMN_USAGE 
WHERE TABLE_NAME = 'Athlete_T' 
  AND CONSTRAINT_NAME = 'PRIMARY';

如果结果仅显示Fname，执行以下SQL修正：

-- 删除旧主键
ALTER TABLE Athlete_T DROP PRIMARY KEY;
-- 添加复合主键
ALTER TABLE Athlete_T ADD PRIMARY KEY (Fname, Lname, DOB);

3. 正确执行验证与保存 #

不要单独调用validate_unique()，而是使用full_clean()触发完整的模型验证（包括复合唯一约束），再执行保存：

def athlete_create(request):
    if request.method == 'POST':
        form = AthleteForm(request.POST)
        if form.is_valid():
            athlete = form.save(commit=False)
            try:
                # 触发所有模型验证，包括复合唯一约束
                athlete.full_clean()
                athlete.save()
                # 跳转成功页面
                return redirect('athlete_list')
            except models.ValidationError as e:
                # 将错误信息添加到表单
                form.add_error(None, e.messages)
    else:
        form = AthleteForm()
    return render(request, 'athlete_create.html', {'form': form})

4. 表单层强化验证（可选） #

如果模型层验证仍有问题，可以在ModelForm的clean方法中手动验证复合唯一：

from django import forms

class AthleteForm(forms.ModelForm):
    class Meta:
        model = Athlete
        fields = ['fname', 'lname', 'dob']

    def clean(self):
        cleaned_data = super().clean()
        fname = cleaned_data.get('fname')
        lname = cleaned_data.get('lname')
        dob = cleaned_data.get('dob')

        # 三个字段都存在时才验证
        if fname and lname and dob:
            if Athlete.objects.filter(
                fname=fname, lname=lname, dob=dob
            ).exists():
                raise forms.ValidationError('该运动员的姓名与出生日期组合已存在')
        return cleaned_data

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