# 42701 — 重复列（duplicate_column）

> PostgreSQL SQLSTATE 42701（重复列，duplicate_column）的源码证据、诊断与处理参考。
---

# 42701 — 重复列

## 速览 {#at-a-glance}

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

<!-- BEGIN SQLSTATE FACTS: generated by scripts/generate.py; do not edit -->

| 字段 | 值 |
| --- | --- |
| SQLSTATE | `42701` |
| 条件名 | `duplicate_column` |
| 状态 | `有效` |
| 已知存在于 | `7.4` |
| 锁定快照 | `9.0.23, 9.1.24, 9.2.24, 9.3.25, 9.4.26, 9.5.25, 9.6.24, 10.23, 11.22, 12.22, 13.23, 14.24, 15.19, 16.15, 17.11, 18.6, 19beta3` |
| 宏 | `ERRCODE_DUPLICATE_COLUMN` |
| 别名 | `—` |

<!-- source facts: data/errcodes/42701.json -->
<!-- END SQLSTATE FACTS -->

## 含义 {#meaning}

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

## 诊断 {#diagnosis}

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

## 处理 {#response}

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

## 报文 {#messages}

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

## 代表案例 {#case}

<!-- BEGIN SQLSTATE SNIPPET: duplicate_column -->

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

```sql
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';
```

<!-- END SQLSTATE SNIPPET -->

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

## 版本 {#versions}

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

## 相关 {#related}

- [`42611` — 列定义无效](../42611/)
- [`42703` — 未定义列](../42703/)

## 来源 {#sources}

- `src.errcodes.18.6` — fixed `errcodes.txt` definition at commit `724edf9bde9d356724ad384a2e196edc3c9f80f7`; SHA-256 `6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba` ([source](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/utils/errcodes.txt)).
- `src.duplicate-column.18.6` — `src/backend/commands/tablecmds.c` at `REL_18_6` commit `724edf9bde9d356724ad384a2e196edc3c9f80f7`; fixed blob SHA-256 `422dc8e833df4940755973c757e338295822ba3e4c7266c40669f49f96eb15a9` ([source](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/commands/tablecmds.c#L2636-L2639)).
- `src.duplicate-column.10.23` — `src/backend/commands/tablecmds.c` at `REL_10_23` commit `02991e79f8f58bc208f05dcc8af0c62dbe0a6ea4`; fixed blob SHA-256 `6de441c88496c6cf57a836898388085ec08bf69afd70d07acdafd6089b9b5f8c` ([source](https://github.com/postgres/postgres/blob/02991e79f8f58bc208f05dcc8af0c62dbe0a6ea4/src/backend/commands/tablecmds.c#L1741-L1744)).
- `src.calls.REL_18_6` / `src.calls.REL_10_23` — fixed call scans, SHA-256 `9ee8a0e81d8f0825c5c1ae45583439859a26e602bdd4ce2f2a62aa278867ccbf` / `00d16d3eb01b71ccf1b245c8f3102f9d0ec9f36fb02777b8dd1b99fcb263040c`.