PostgreSQL并发执行CREATE TABLE IF NOT EXISTS报23505错误的原因与解决

PostgreSQL 的 CREATE TABLE IF NOT EXISTS 并非完全无竞争的原子操作，它的执行分两步走：

• 先检查目标 schema 里有没有同名表；
• 要是没查到，就执行表创建逻辑。

在多进程并发执行的时候，很可能多个进程同时通过了第一步的检查（都觉得表不存在），接着同时去创建表。第一个进程成功建表后，后续进程再插入系统表 pg_class 时，就会因为（表名、命名空间）的组合重复，触发 pg_class_relname_nsp_index 这个唯一约束，抛出 23505 错误。

CREATE INDEX IF NOT EXISTS 出现类似失败也是同一个道理：检查索引是否存在和实际创建之间的时间窗口，被并发请求钻了空子。

1. 提前初始化表（最省心的方案） #

如果业务允许，别让程序在启动时动态建表，而是在部署阶段用单进程一次性执行完所有 CREATE TABLE IF NOT EXISTS 和 CREATE INDEX IF NOT EXISTS 语句，确保所有表结构在程序并发运行前就已经存在，从根源上避免竞争。

2. 用数据库咨询锁做并发控制 #

在执行创建语句前，先获取一个针对该表的专属咨询锁，保证同一时间只有一个进程在尝试创建操作。示例代码：

-- 获取锁：用表的OID作为锁ID，确保唯一
SELECT pg_advisory_lock(('log'::text)::regclass::oid);
CREATE TABLE IF NOT EXISTS log (...);
CREATE INDEX IF NOT EXISTS idx_log_xxx ON log(...);
-- 释放锁
SELECT pg_advisory_unlock(('log'::text)::regclass::oid);

也可以用事务级别的咨询锁，事务结束自动释放，不用手动解锁：

BEGIN;
SELECT pg_advisory_xact_lock(('log'::text)::regclass::oid);
CREATE TABLE IF NOT EXISTS log (...);
CREATE INDEX IF NOT EXISTS idx_log_xxx ON log(...);
COMMIT;

3. 封装成函数捕获异常 #

把创建逻辑打包成PL/pgSQL函数，专门捕获 23505 唯一约束异常并忽略——因为出现这个异常时，说明表或索引已经被其他进程创建好了，不需要再做任何操作。示例：

CREATE OR REPLACE FUNCTION init_log_table() RETURNS void AS $$
BEGIN
    CREATE TABLE IF NOT EXISTS log (...);
    CREATE INDEX IF NOT EXISTS idx_log_xxx ON log(...);
EXCEPTION
    WHEN unique_violation THEN
        -- 冲突说明表/索引已存在，直接忽略
        NULL;
END;
$$ LANGUAGE plpgsql;

程序里直接调用 SELECT init_log_table(); 就行，就算并发调用，冲突的请求也会捕获异常正常返回，不会崩溃。

4. 应用层加全局锁 #

如果你的程序部署在同一个集群，或者能用到Redis这类分布式锁服务，可以在应用代码里先获取锁，拿到锁之后再执行SQL创建语句，确保同一时间只有一个进程在执行创建操作。

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