确保 Django 模型中姓名和姓氏的唯一性-Python教程-PHP中文网

确保 Django 模型中姓名和姓氏的唯一性

霞舞

发布： 2025-11-02 12:34:11

原创

396人浏览过

确保 django 模型中姓名和姓氏的唯一性

本文介绍了如何在 Django 模型中确保姓名和姓氏的组合是唯一的。通过使用 `unique_together` 约束和模型验证，可以防止在数据库中保存重复的人员信息，从而避免数据不一致的问题。本文提供了详细的代码示例和解释，帮助开发者轻松实现这一功能。

在 Django 项目中，确保数据的唯一性至关重要，尤其是在处理人员信息时。如果允许重复的姓名和姓氏组合存在，可能会导致数据混淆和应用程序逻辑错误。本文将介绍如何使用 Django 提供的功能，强制 JrtnPerson 模型中的 name 和 surname 字段组合保持唯一。

使用 unique_together 约束

Django 的模型元选项 unique_together 允许你指定模型中哪些字段的组合必须是唯一的。这是一种声明性方法，简单易用。

在 JrtnPerson 模型中，我们可以添加一个 Meta 类，并在其中定义 unique_together：

from django.db import models
from phonenumber_field.modelfields import PhoneNumberField

class Drtn(models.Model): # 假设 Drtn 模型已定义
    name_short = models.CharField(max_length=200)
    name_full = models.CharField(max_length=200)

    def __str__(self):
        return self.name_short

class JrtnPerson(models.Model):
    rtn = models.ForeignKey(Drtn, verbose_name='Подразделение Ростехнадзора', on_delete=models.CASCADE)
    name = models.CharField(max_length=200, verbose_name='Имя и Отчество')
    surname = models.CharField(max_length=200, verbose_name='Фамилия')
    tel_mob = PhoneNumberField(verbose_name="Номер телефона мобильный", blank=True, null=True)
    tel_rab = PhoneNumberField(verbose_name="Номер телефона рабочий", blank=True, null=True)
    email = models.EmailField(max_length=100, verbose_name="Электронная почта", blank=True, null=True)

    class Meta:
        unique_together = ('name', 'surname')

    def __str__(self):
        return f'{self.surname} {self.name}'

登录后复制

这段代码会在数据库级别强制 name 和 surname 的组合是唯一的。如果尝试保存具有相同 name 和 surname 的 JrtnPerson 实例，Django 将会抛出一个 IntegrityError 异常。

盘古大模型

华为云推出的一系列高性能人工智能大模型

查看详情

模型验证

虽然 unique_together 约束在数据库级别强制了唯一性，但最好在保存模型之前进行验证，以便在更早的阶段捕获错误。这可以通过覆盖模型的 save() 方法，并在其中调用 full_clean() 方法来实现。full_clean() 方法会执行模型的所有验证，包括 unique_together 约束。

from django.core.exceptions import ValidationError

class JrtnPerson(models.Model):
    rtn = models.ForeignKey(Drtn, verbose_name='Подразделение Ростехнадзора', on_delete=models.CASCADE)
    name = models.CharField(max_length=200, verbose_name='Имя и Отчество')
    surname = models.CharField(max_length=200, verbose_name='Фамилия')
    tel_mob = PhoneNumberField(verbose_name="Номер телефона мобильный", blank=True, null=True)
    tel_rab = PhoneNumberField(verbose_name="Номер телефона рабочий", blank=True, null=True)
    email = models.EmailField(max_length=100, verbose_name="Электронная почта", blank=True, null=Null)

    class Meta:
        unique_together = ('name', 'surname')

    def save(self, *args, **kwargs):
        try:
            self.full_clean()
        except ValidationError as e:
            # 处理验证错误，例如记录日志或向用户显示错误消息
            print(f"Validation Error: {e}")
            raise  # 重新引发异常，以便调用者知道保存失败
        super().save(*args, **kwargs)

    def __str__(self):
        return f'{self.surname} {self.name}'

登录后复制

在这个例子中，save() 方法首先调用 full_clean() 来验证模型。如果验证失败（例如，因为违反了 unique_together 约束），则会抛出一个 ValidationError 异常。你可以捕获这个异常并采取适当的措施，例如记录错误或向用户显示错误消息。 raise 语句重新引发异常，确保调用者知道保存操作失败。

注意事项

数据库迁移: 在添加或修改 unique_together 约束后，需要运行 python manage.py makemigrations 和 python manage.py migrate 来更新数据库模式。
错误处理: 确保正确处理 ValidationError 和 IntegrityError 异常，以便在发生唯一性冲突时提供友好的用户体验。
性能: 对于大型数据集，考虑在 name 和 surname 字段上创建索引，以提高查询性能。