迁移MySQL数据库到Django时唯一约束外键报错求助

问题根源 #

Django的外键字段要求指向的目标字段必须是唯一的（要么是主键，要么设置了unique=True，或者属于无条件的UniqueConstraint）。你当前的Ticket模型中，airline_name和departure_datetime作为外键指向Flight的对应字段，但这两个字段本身并不具备唯一性：

• Flight.airline_name是关联Airline的外键，同一航空公司可以对应多个航班
• Flight.departure_datetime是起飞时间，同一时间可以有多个航班
  只有flight_number是Flight的主键（天然唯一），三个字段的组合虽有唯一约束，但单字段不满足外键的唯一性要求，因此触发fields.E311错误。

解决方案 #

最优方案：合并外键字段 #

将Ticket中拆分的三个外键替换为一个指向Flight的外键，这符合ORM关联设计逻辑（一张机票属于一个航班），同时解决唯一性问题：

修改后的Ticket模型代码：

class Ticket(models.Model):
    ticket_id = models.AutoField(primary_key=True)
    customer = models.ForeignKey(Customer, models.DO_NOTHING)
    # 用单个外键关联Flight，对应数据库表的flight_number字段
    flight = models.ForeignKey(Flight, models.DO_NOTHING, db_column='flight_number', related_name='tickets')
    first_name = models.CharField(max_length=20)
    last_name = models.CharField(max_length=20)
    email = models.CharField(max_length=100)
    date_of_birth = models.DateField()

    class Meta:
        managed = False
        db_table = 'ticket'
        constraints = [
            # 调整唯一约束，通过flight外键关联到航班的唯一标识
            models.UniqueConstraint(fields=['flight', 'first_name', 'last_name', 'email', 'date_of_birth'], name='unique_ticket')
        ]

兼容现有数据库结构的备选方案 #

如果因为数据库表结构已固定（managed=False），必须保留ticket表中的flight_number、airline_name、departure_datetime三个字段，可以将这三个字段改为普通字段（非外键），然后通过自定义逻辑关联Flight：

class Ticket(models.Model):
    ticket_id = models.AutoField(primary_key=True)
    customer = models.ForeignKey(Customer, models.DO_NOTHING)
    # 改为普通字段，对应数据库列
    flight_number = models.PositiveIntegerField()
    airline_name = models.ForeignKey(Airline, models.DO_NOTHING, db_column='airline_name')
    departure_datetime = models.DateTimeField()
    first_name = models.CharField(max_length=20)
    last_name = models.CharField(max_length=20)
    email = models.CharField(max_length=100)
    date_of_birth = models.DateField()

    class Meta:
        managed = False
        db_table = 'ticket'
        constraints = [
            models.UniqueConstraint(fields=['flight_number', 'airline_name', 'departure_datetime', 'first_name', 'last_name', 'email', 'date_of_birth'], name='unique_ticket')
        ]

    # 自定义方法获取关联的Flight记录
    def get_flight(self):
        return Flight.objects.get(flight_number=self.flight_number, airline_name=self.airline_name, departure_datetime=self.departure_datetime)

关键说明 #

• 不要尝试给Flight.airline_name或Flight.departure_datetime添加unique=True，这不符合业务逻辑（同一航空公司/同一时间可以有多个航班），会导致数据插入失败。
• 单个外键的设计更符合Django ORM的最佳实践，能直接通过ticket.flight获取航班的所有关联数据，无需额外查询。

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