Django单元测试遇IntegrityError：如何忽略重复键约束冲突？

问题根源 #

你碰到的django.db.utils.IntegrityError是因为所有继承CommonLoanOptions的模型（LoanType、LoanUsage、Profession）都有name字段唯一约束，测试时重复创建了同名实例导致冲突。具体原因可能是：

• 创建LoanType、LoanUsage时未指定name，使用了默认值（比如空字符串），多次运行测试就会出现重复；
• tearDown仅删除了loan_type和loan_usage，未清理profession实例，后续测试再创建同名Profession就会触发约束错误；
• 少数情况下，测试的事务隔离未生效，导致数据残留到下一个测试用例。

解决办法 #

1. 显式指定唯一name值 #

创建实例时给每个模型设置不重复的name，避免默认值冲突：

def setUp(self) -> None:
    self.loan_product = mock.Mock(spec=LoanProduct)
    # 给每个实例设置唯一名称
    self.loan_type = LoanType.objects.create(name="测试贷款类型")
    self.loan_usage = LoanUsage.objects.create(name="测试贷款用途")
    self.profession = Profession.objects.create(name='Architekt/in')

2. 完善清理逻辑 #

把profession也加入tearDown，确保每次测试后清空所有创建的实例：

def tearDown(self) -> None:
    self.loan_type.delete()
    self.loan_usage.delete()
    self.profession.delete()

3. 用get_or_create避免重复 #

如果需要复用实例，使用get_or_create方法——不存在就创建，存在则直接获取，不会触发唯一约束：

def setUp(self) -> None:
    self.loan_product = mock.Mock(spec=LoanProduct)
    self.loan_type, _ = LoanType.objects.get_or_create(name="测试贷款类型")
    self.loan_usage, _ = LoanUsage.objects.get_or_create(name="测试贷款用途")
    self.profession, _ = Profession.objects.get_or_create(name='Architekt/in')

4. 改用TransactionTestCase彻底清理数据 #

如果是测试间数据污染的问题，TestCase默认用事务回滚隔离数据，但如果你的测试涉及跨事务操作，换成TransactionTestCase，它会在每个测试后截断数据库表，彻底清空数据：

from django.test import TransactionTestCase

class BankLoanApplicationFile(TransactionTestCase):
    # 测试代码保持不变

5. 临时捕获错误（仅应急用） #

如果确实需要临时绕过错误，可以用try-except捕获，但这会掩盖真实问题，不推荐长期使用：

import django.db.utils

def setUp(self) -> None:
    self.loan_product = mock.Mock(spec=LoanProduct)
    try:
        self.loan_type = LoanType.objects.create()
    except django.db.utils.IntegrityError:
        self.loan_type = LoanType.objects.first()
    # 其他实例同理处理

注意 #

优先保证测试数据的唯一性，忽略错误是下策，会导致测试结果不可靠。尽量依赖Django自带的测试隔离机制，手动清理容易遗漏数据。

内容的提问来源于stack exchange，提问作者Lutaaya Huzaifah Idris