PostgreSQL是否保证带唯一约束的UUID列生成唯一随机UUID？

问题场景 #

给定如下表结构：

CREATE TABLE the_table (
  the_uuid UUID NOT NULL UNIQUE DEFAULT gen_random_uuid()
  -- 更多列
);

当插入行时不指定the_uuid列的值，由PostgreSQL自动生成随机UUID，是否会自动处理UUID重复的极端情况？比如自动重试生成直到得到唯一值？毕竟UUID类型没有类似数值型SEQUENCE的内置不重复机制，虽然重复概率极低，但还是想明确PostgreSQL的处理方式。

核心结论 #

PostgreSQL不会自动重试生成UUID。当gen_random_uuid()生成的UUID恰好与表中已存在值重复时，插入操作会直接抛出唯一约束违反的错误，不会自行重试。

具体逻辑说明 #

1. gen_random_uuid()在插入语句执行的早期阶段生成值，生成后直接作为待插入值提交给数据库引擎。
2. 数据库仅在插入操作的最后阶段检查唯一约束，一旦发现冲突，直接抛出错误终止插入流程，不会回溯重新生成UUID。

规避重复的手动方案 #

如果确实要覆盖这种极端场景，需要手动实现重试逻辑：

• 应用层方案：在代码中捕获唯一约束违反的异常，重新执行插入操作即可。
• 数据库层方案：编写PL/pgSQL函数，在函数内部循环生成UUID并尝试插入，直到成功或达到预设重试次数，示例代码如下：

CREATE OR REPLACE FUNCTION insert_the_table(p_other_column TEXT)
RETURNS void AS $$
DECLARE
  v_uuid UUID;
  v_retry_count INT := 0;
  v_max_retries INT := 5; -- 设定最大重试次数
BEGIN
  LOOP
    v_uuid := gen_random_uuid();
    BEGIN
      INSERT INTO the_table (the_uuid, other_column) VALUES (v_uuid, p_other_column);
      EXIT;
    EXCEPTION WHEN unique_violation THEN
      v_retry_count := v_retry_count + 1;
      IF v_retry_count >= v_max_retries THEN
        RAISE EXCEPTION 'Failed to generate unique UUID after % retries', v_max_retries;
      END IF;
    END;
  END LOOP;
END;
$$ LANGUAGE plpgsql;

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