PostgreSQL单记录表ON CONFLICT更新失败求助

错误原因 #

你遇到的错误核心是**ON CONFLICT指定的冲突目标与实际存在的唯一约束/索引不匹配**：

• 你创建的唯一索引是基于常量表达式((true))的函数型索引，作用是强制表中只能存在一行（所有行的true值相同，唯一索引不允许重复）。
• 但你在INSERT ... ON CONFLICT中指定的是(one_row)，PostgreSQL会尝试查找针对one_row列的唯一约束或索引，而你的索引和one_row列无关联，因此无法匹配，抛出错误。

修复方案 #

有两种可行的修复方式，可根据需求选择：

方式一：适配现有表达式索引 #

若想保留当前表结构和表达式索引，需修改ON CONFLICT的冲突目标，匹配索引的表达式或名称：

方法1：使用表达式作为冲突目标

直接引用索引对应的常量表达式：

insert into one_row_table (id) values ('3') 
ON CONFLICT ((true)) DO UPDATE SET id = EXCLUDED.id;

方法2：使用索引名称指定冲突约束

利用你创建索引时指定的名称one_row_only_uidx_one_row_table：

insert into one_row_table (id) values ('3') 
ON CONFLICT ON CONSTRAINT one_row_only_uidx_one_row_table DO UPDATE SET id = EXCLUDED.id;

方式二：重构表结构（推荐） #

既然one_row列默认值为1，且目标是限制表仅一行，直接给one_row列添加唯一约束（或主键约束）更直观，后续维护更简单：

-- 删除原有表（若已存在）
DROP TABLE IF EXISTS one_row_table;

CREATE TABLE IF NOT EXISTS one_row_table
(
    one_row INT NOT NULL DEFAULT 1 UNIQUE, -- 唯一约束限制该列仅能有一个值
    id      varchar(255) NOT NULL
);

-- 插入第一行数据
insert into one_row_table (id) values ('2');

-- 现在可正常使用ON CONFLICT (one_row)执行更新
insert into one_row_table (id) values ('3') ON CONFLICT (one_row) DO UPDATE SET id = EXCLUDED.id;

如果需要更强约束（确保one_row只能是1），可追加检查约束：

CREATE TABLE IF NOT EXISTS one_row_table
(
    one_row INT NOT NULL DEFAULT 1 UNIQUE CHECK (one_row = 1),
    id      varchar(255) NOT NULL
);

这样既限制表仅一行，还能防止one_row列被修改为其他数值。

内容的提问来源于stack exchange，提问作者M-Wajeeh