如何修复 PostgreSQL 中重复键值违反唯一约束：开发人员生存指南

啊，可怕的重复键值违反了 PostgreSQL 中的唯一约束错误。就像有一位朋友总是不请自来参加你的聚会，吃掉所有的零食，然后不帮忙打扫就离开。但别担心，我们都经历过。无论您是初学者还是中级 C# 开发人员，本指南都将帮助您通过幽默和流行文化参考来消除此错误。让我们开始吧！

这个错误到底是什么？

想象一下，您正在听音乐会，保镖正在检查门票。每张票都有一个唯一的号码，并且不能有两个人拥有相同的票。突然，有人试图偷偷溜进来，拿着一张重复的票。一片混乱，保镖大发雷霆。当您尝试插入一条带有已存在的主键或唯一约束的记录时，PostgreSQL 数据库中就会发生这种情况。

错误消息可能如下所示：

vbnet 复制代码

ERROR: duplicate key value violates unique constraint "Accounts_new_pkey1"
DETAIL: Key (account_id)=(123) already exists.

Enter fullscreen mode Exit fullscreen mode

用人类的话说就是："嘿，你想添加一些已经存在的东西。停下来！"

为什么会发生这种情况？

在修复之前，让我们先了解一下为什么会发生这种情况。以下是常见的原因：

您正在插入重复数据

您正在尝试插入表中已有的主键或唯一值的记录。这就像试图为反叛联盟添加第二个卢克·天行者一样，反叛联盟只能有一个（好吧，除非您算上克隆人）。
您的序列不同步

如果您使用的是 SERIAL 或 BIGSERIAL 列（自动生成唯一 ID），则序列可能不同步。想象一下，一位 DJ 忘记了刚刚播放了哪首曲目，然后开始重复播放同一首歌曲。真尴尬。
竞争条件

在多用户环境中，两个进程可能会尝试同时插入相同的值。这就像两个人同时抢最后一片披萨。戏剧性的事情随之而来。

如何修复：分步指南

现在我们知道了罪魁祸首，让我们来修复问题。拿起你的光剑（或咖啡），让我们开始工作吧。

步骤 1：确定有问题的列

首先，找出导致问题的列。错误消息通常会告诉您约束名称（例如，Accounts_new_pkey1）和表名称（例如，Accounts）。使用它来查找列。

运行此查询来检查表：

复制代码

d+ Accounts

Enter fullscreen mode Exit fullscreen mode

查找具有 PRIMARY KEY 或 UNIQUE 约束的列。这就像在《星球大战》电影中找到流氓机器人一样，一旦您发现它，您就成功了一半。

第 2 步：检查重复数据

如果您手动插入数据，请检查该值是否已存在。例如，如果 account_id = 123 导致错误，请运行：

ini 复制代码

SELECT * FROM Accounts WHERE account_id = 123;

Enter fullscreen mode Exit fullscreen mode

如果出现记录，则表明您找到了重复项。决定是否更新现有记录或生成新的唯一值。

步骤 3：修复序列（如果序列不同步）

如果问题出在 SERIAL 或 BIGSERIAL 列上，则序列可能不同步。修复方法如下：

A. 查找序列名称

序列名称通常采用 __seq 格式。例如：

arduino 复制代码

SELECT pg_get_serial_sequence('Accounts', 'account_id');

Enter fullscreen mode Exit fullscreen mode

输出：

arduino 复制代码

public.Accounts_account_id_seq

Enter fullscreen mode Exit fullscreen mode

B.检查当前序列值

跑步：

sql 复制代码

SELECT last_value FROM Accounts_account_id_seq;

Enter fullscreen mode Exit fullscreen mode

C. 检查表中的最大值

跑步：

sql 复制代码

SELECT MAX(account_id) FROM Accounts;

Enter fullscreen mode Exit fullscreen mode

注意：如果步骤 B 和 C 的值之间存在差异，则可能必须通过运行以下命令重置序列：

sql 复制代码

SELECT setval('Accounts_account_id_seq', (SELECT MAX(account_id) FROM Accounts));

Enter fullscreen mode Exit fullscreen mode

或者，如果您希望下一个值更大：

sql 复制代码

SELECT setval('Accounts_account_id_seq', (SELECT MAX(account_id) + 1 FROM Accounts));

Enter fullscreen mode Exit fullscreen mode

想象一下将磁带倒回到正确的轨道。现在您的序列已恢复同步，您可以开始摇滚了。

步骤 4：处理竞争条件（如果适用）

如果您正在处理并发插入，则可能需要处理竞争条件。在 C# 代码中使用数据库级锁定或重试逻辑。例如：

csharp 复制代码

try
{
    // Attempt to insert the record
}
catch (PostgresException ex) when (ex.SqlState == "23505")
{
    // Handle the duplicate key error (e.g., retry or log)
}

Enter fullscreen mode Exit fullscreen mode

这就像玩抢椅子的游戏，当音乐停止时，确保你是唯一一个坐下的人。

预防未来错误

使用 UUID 作为唯一键

如果您担心重复，请考虑使用 UUID 而不是整数。它们就像雪花一样，没有两片是相同的。
插入前验证数据

插入新记录前务必检查现有记录。这就像订购外卖前检查冰箱一样。
监控您的序列

密切关注您的序列，特别是在数据导入或手动插入后。一点点维护就会有很大的帮助。

结论

修复重复键值违反唯一约束错误不一定是一场噩梦。有了正确的工具和一点幽默感，您就可以像专业人士一样解决这个问题。无论您要处理重复数据、不同步序列还是竞争条件，本指南都能满足您的需求。

原文地址：mp.weixin.qq.com/s/ZQFgYGbD4...

本文由博客一文多发平台 OpenWrite 发布！