CockroachDB仲裁丢失重试插入时出现重复键值问题

先对齐下你的测试场景，确保我没理解错：

• 给3节点CockroachDB集群循环插记录
• 关掉2个节点模拟仲裁丢失
• 等Postgres JDBC驱动抛出IO异常
• 重启1个节点恢复集群仲裁
• 重试之前失败的插入，结果碰到Duplicate key value异常

问题到底出在哪？ #

这本质是分布式系统的**「不确定结果」问题**：你发起插入请求后，集群因为丢了仲裁没法给你明确的成功响应，但实际上这个插入可能已经在集群里“半成功”了——比如leader节点已经把数据写到本地盘，但还没来得及同步到足够多的follower，集群就挂了。等你恢复仲裁后，CockroachDB的Raft协议会自动把这些“半成功”的数据同步完成，最终这条记录会被正式写入集群。而你的客户端因为收到了IO异常，以为请求彻底失败，重试自然就撞了唯一键。

说直白点：你以为第一次插入失败了，但其实它在集群恢复后“偷偷”成功了，你不知情的情况下重试，就触发了重复键冲突。

怎么解决？ #

针对这种场景，有几个实用的处理方案，按推荐程度排序：

1. 给插入语句加幂等性（最推荐） #

直接修改SQL，让它重复执行也不会炸——用CockroachDB支持的INSERT ... ON CONFLICT语法就行：

INSERT INTO your_table (id, column1, column2)
VALUES (123, 'foo', 'bar')
ON CONFLICT (id) DO NOTHING; -- 或者根据业务需求选 DO UPDATE SET ...

这样就算之前的插入已经成功，重试时要么静默跳过，要么更新现有记录（看你业务需要），绝不会抛出重复键异常。

2. 用好CockroachDB JDBC驱动的重试配置 #

CockroachDB的JDBC驱动本身就内置了重试逻辑，你可以在连接URL里开启相关参数：

jdbc:postgresql://your-cluster:26257/your-db?retryWrites=true&maxRetries=5

不过要注意：这种重试只覆盖CockroachDB能识别的可重试错误（比如事务重试信号），对于IO超时这类客户端层面的错误，可能得结合自己的逻辑。

3. 重试前先查一下（兜底方案） #

如果不想改SQL，那就在重试之前先确认记录是否存在：

• 收到IO异常后，别立刻重试，先等集群稳定个几秒
• 执行一次强一致性查询，检查要插入的记录是否已经存在：

  SET TRANSACTION CONSISTENCY = STRONG;
  SELECT id FROM your_table WHERE id = 123;
  

• 如果查到记录，就跳过重试；没查到再执行插入

这种方式要注意一致性级别，必须用STRONG，不然可能查到旧数据导致误判。

最后总结下 #

这种问题是分布式数据库在节点/网络故障下的典型表现，核心就是要处理「请求结果不确定」的情况。最省心的办法就是让你的数据库操作具备幂等性，不管重试多少次，都不会搞乱数据。

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