Django中FOREIGN KEY约束失败问题排查与解决求助

问题场景 #

在Django电商项目中，尝试将Supermarket（对应模型Lojista）与Product（对应模型Produto）关联时触发FOREIGN KEY constraint failed错误，不确定是迁移操作还是数据模型设计导致的问题。项目中用户分为Customer（Client）和Supermarket（Lojista）两种角色，单个用户仅能对应一种角色，一个Lojista可关联多个Produto。

相关模型代码 #

products/models.py #

class Categoria(models.Model):
    nome = models.CharField(max_length=50)

    def __str__(self):
        return self.nome


class Produto(models.Model):
    name = models.CharField(max_length=70)
    price = models.FloatField()
    qnt_stock = models.IntegerField()
    sold = models.IntegerField()
    category = models.ForeignKey(Categoria, on_delete=models.CASCADE)
    description = models.TextField(default="", blank=True, null=True)
    slug = models.SlugField(unique=True)
    image = models.ImageField(upload_to="products/%Y/%m/%d", blank=True, null=True)
    expiration_date = models.DateTimeField(null=True, blank=True)
    supermarket = models.ForeignKey(
        Lojista, on_delete=models.CASCADE, blank=True, null=True
    )

    def __str__(self):
        return self.name

    def get_absolute_url(self):
        return reverse("produtos:produto_detail", kwargs={"slug": self.slug})

users/models.py #

class CustomUser(AbstractUser):
    class Role(models.TextChoices):
        SUPERMARKET = "SUPERMARKET", _("Supermarket")
        CLIENT = "CLIENT", _("Client")

    role = models.CharField(max_length=50, choices=Role.choices)

    def __str__(self):
        return self.username


class Client(models.Model):
    user = models.OneToOneField(CustomUser, on_delete=models.CASCADE, primary_key=True)

    def __str__(self):
        return self.user.username


class Lojista(models.Model):
    def upload_photo_to(instance, filename):
        return f"brand/{instance.name}/{filename}"

    supermarket = models.OneToOneField(
        CustomUser, on_delete=models.CASCADE, primary_key=True
    )
    brand = models.ImageField(upload_to=upload_photo_to, blank=True, null=True)
    cep = BRPostalCodeField()
    state = models.CharField(choices=br_states.STATE_CHOICES, max_length=2, null=False)
    city = models.CharField(max_length=128, null=False)
    district = models.CharField(max_length=128, null=True)
    street = models.CharField(max_length=128, null=True)

    def __str__(self):
        return f"{self.supermarket.username} - {self.street}, {self.district} - {self.city}/{self.state}"

错误信息 #

IntegrityError at /admin/produtos/produto/2/change/
FOREIGN KEY constraint failed

排查分析与解决方案 #

模型设计合理性 #

首先确认：Produto的supermarket字段是指向Lojista的外键，设置了blank=True和null=True，允许为空，符合"一个Lojista对应多个Produto"的业务逻辑，模型设计本身不存在明显问题，错误更可能来自数据或迁移环节。

可能的原因及解决办法 #

• 关联的Lojista实例不存在
  检查后台选中的Lojista记录是否已被删除，或者是否手动传入了不存在的Lojista ID。确保关联的目标Lojista实例在数据库中存在。

• 迁移历史不一致
  执行以下命令确保迁移完全应用：

  python manage.py makemigrations
  python manage.py migrate
  

  检查迁移过程中是否有报错，若存在迁移冲突，可尝试回滚到上一个正常版本后重新生成迁移。

• 数据库表结构与模型不匹配
  手动检查数据库中produtos_produto表的supermarket_id字段：

  • 确认该字段允许NULL值；
  • 确认外键约束正确指向users_lojista表的主键（即user_id）。

• 现有Produto数据的关联失效
  如果是修改已有Produto记录触发错误，检查该记录之前关联的Lojista是否已被删除。尝试新建一个Produto并关联存在的Lojista，验证是否能正常保存。

• Lojista实例的完整性问题
  Lojista通过OneToOneField关联CustomUser作为主键，需确保要关联的Lojista对应的CustomUser实例存在，且业务上CustomUser的role为SUPERMARKET（虽然模型未强制约束，但需保证数据一致性）。

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