42701 duplicate_column

速览

SQLSTATE 42701 是 Class 42 中的 duplicate_column。42701 表示重复列。选定的 CREATE TABLE 路径两次列出 id，在创建修正后的不同列之前报告 column "%s" specified more than once。

含义

42701 表示重复列。在处理表定义时，PostgreSQL 会先比较本地 ColumnDef 名称，再合并继承属性。因此在一个定义中两次列出同名列会在创建修复表前报告 ERROR：column "%s" specified more than once。这个本地名称检查不同于继承默认值、类型或排序规则冲突；后者可能使用其他 SQLSTATE。

诊断

检查展开后的生成列列表，包括带引号标识符，以及拼接到同一个 CREATE TABLE 中的迁移片段。PostgreSQL 在普通名称处理后比较标识符，因此意外重复的未引用名称仍然是同一列名。选定 DDL 的 ERROR 后自动提交会话仍为 IDLE；显式 BEGIN 中同样的错误会让事务进入 INERROR，必须 ROLLBACK 或回滚到合适保存点后再重试。要把它与 42611 的继承默认值冲突，以及继承列合并时的类型/排序规则错误区分开。

处理

删除重复定义或给它一个有意的不同名称，重新执行完整 DDL，并检查最终目录。如果重复来自已经执行过的迁移，先比较现有表定义，再决定使用 ALTER TABLE 还是新的 CREATE TABLE；不要假设失败的 CREATE TABLE 留下了半成品关系。选定修复创建 id 和 payload 两列并确认列数。

报文

选定的 tablecmds.c 分支以明确的 ERROR 发出主报文 column "%s" specified more than once；%s 是重复列名。相邻源码分支可能为继承类型/排序规则冲突发出其他 SQLSTATE。只有客户端异常而没有服务器 SQLSTATE 和主报文时，不能据此认定 42701。

代表案例

本页使用与运行器注册表相同的语句。执行时，syntax_schema、syntax_role 等生成名称会替换为一次性实例中的实际值。

CREATE TABLE syntax_schema.duplicate_table (id integer, id text);
CREATE TABLE syntax_schema.repaired_table (id integer, payload text);
SELECT count(*) FROM information_schema.columns WHERE table_schema = 'syntax_schema_name' AND table_name = 'repaired_table_name';

选定的 18.6 运行记录结构化诊断并通过修复断言；10.21 运行通过同一案例的具体检查。可下载的案例和证据投影分别是 42701 案例 JSON 和 作者证据。运行器清单为 verify/cases/42701/cases.json，页面 SQL 会与共享注册表核对。

版本

选定的自然运行范围是 PostgreSQL 18.6 与 10.21，不能据此推断所有中间版本的行为。

相关

• 42611 — 列定义无效
• 42703 — 未定义列

来源

• 上游源码 src/backend/commands/tablecmds.c 第 1741–1744 行 REL_10_23 02991e79f 6de441c8
• 上游源码 src/backend/commands/tablecmds.c 第 2636–2639 行 REL_18_6 724edf9bd 422dc8e8
• 上游源码 src/backend/utils/errcodes.txt REL_18_6 724edf9bd 6e8de346
• 核验材料 verify/cases/42701/cases.json 9f792ba4
• 核验材料 verify/cases/42701/snippets.json 20767b21
• 核验材料 raw/calls/REL_10_23.jsonl 00d16d3e
• 核验材料 raw/calls/REL_18_6.jsonl 9ee8a0e8