Peewee+PostgreSQL：双字段冲突时忽略插入失效问题排查

你遇到的核心问题是数据库中没有针对user_id和answered_at的组合唯一约束，导致on_conflict无法识别冲突，所以action='ignore'完全不起作用，重复数据依然会被插入。

为什么当前代码不生效？ #

on_conflict方法的conflict_target参数依赖数据库层面的唯一约束/唯一索引来判断“冲突”——数据库必须知道(user_id, answered_at)的组合是唯一的，才能检测到重复插入的冲突并执行忽略操作。你现在的模型定义里没有这个约束，数据库根本不知道要检查什么冲突，自然会直接插入所有数据。

正确的模型修改方式 #

你需要在NPS模型的Meta类中添加组合唯一约束，有两种常用写法：

写法1：使用unique_together（peewee的便捷写法）

class NPS(BaseModel):
    class Meta:
        schema = os.getenv('SCHEMANAME')
        table_name = os.getenv('TABLENAME')
        # 定义user_id和answered_at的组合唯一约束
        unique_together = (('user_id', 'answered_at'),)
    
    user_id = pw.IntegerField()
    answered_at = pw.DateField()
    score = pw.IntegerField()
    motivation = pw.TextField()
    comment = pw.TextField(null=True)
    attempts = pw.DateField()
    scores = pw.TextField()

写法2：使用UniqueConstraint（更灵活，可自定义约束名称）

class NPS(BaseModel):
    class Meta:
        schema = os.getenv('SCHEMANAME')
        table_name = os.getenv('TABLENAME')
        constraints = [
            pw.UniqueConstraint(
                'user_id', 
                'answered_at', 
                name='nps_user_answered_unique'  # 自定义约束名称，方便后续维护
            )
        ]
    
    # 字段定义不变...

关键注意事项 #

1. 必须迁移数据库：修改模型后，你需要生成并执行数据库迁移脚本，让这个唯一约束真正在数据库表中生效。如果是新表，重新创建表即可；如果是已存在的表，需要用迁移工具（比如peewee的playhouse.migrate）添加约束。
2. action='ignore'是正确的：这个参数对应数据库的冲突忽略逻辑（比如PostgreSQL的ON CONFLICT DO NOTHING，MySQL的INSERT IGNORE），写法没问题，只要约束生效，它就会起作用。
3. 不要用Check约束做唯一检查：你提到的Check('user_id AND answered_at NOT EXISTS')是错误的用法——Check约束是用来验证字段值的规则（比如score BETWEEN 0 AND 10），根本无法实现组合唯一的功能，完全没必要加这个。

验证效果 #

当约束生效后，再执行你的插入代码：

cursor = (
    NPS
    .insert_many(dados_nps)
    .on_conflict(conflict_target=[NPS.user_id, NPS.answered_at], action='ignore')
    .returning()
)
inserted_rows = cursor.execute()
print(inserted_rows)

此时inserted_rows只会返回实际插入的新行数，重复的(user_id, answered_at)组合会被自动忽略。

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