# 42712 — 重复别名（duplicate_alias）

> PostgreSQL SQLSTATE 42712（重复别名，duplicate_alias）的源码证据、诊断与处理参考。
---

# 42712 — 重复别名（duplicate_alias）

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

`42712` 是 **duplicate_alias（重复别名）**：同一查询命名空间重复使用表别名。解析器拒绝两个都叫 `duplicate_alias` 的 `VALUES` 表项。

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

| 字段 | 值 |
| --- | --- |
| SQLSTATE | `42712` |
| 条件名 | `duplicate_alias` |
| 状态 | `有效` |
| 已知存在于 | `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_ALIAS` |
| 别名 | `—` |

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

## 含义 {#meaning}

别名属于查询命名空间，第二个同名范围表在执行前就有歧义。它不同于重复物理对象 `42710` 和重复输出列名。检查 FROM/JOIN/CTE/子查询别名；自动提交错误后为 `IDLE`。

## 诊断 {#diagnosis}

检查 FROM、JOIN、CTE 和子查询的每个别名，也检查生成 SQL 引入的别名。冲突发生在当前查询命名空间，search_path 或修改基础表名不是诊断方向。

## 处理 {#response}

给范围表使用不同别名并限定列。改基础表名或 `search_path` 不能修复当前查询。显式事务中的解析失败会使事务进入 `INERROR`，应先回滚或回到合适的 savepoint 再重试；本案例的自动提交路径回到 `IDLE`。

## 实测诊断 {#messages}

固定解析器组是 `ERROR`，主模板为 `table name "%s" specified more than once`，没有 DETAIL/HINT。

## 代表案例 {#case}

案例让两个单行 VALUES 表项先同名，再改成 `left_alias`/`right_alias` 并断言两个值。

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

```sql
SELECT * FROM (VALUES (1)) AS duplicate_alias(value), (VALUES (2)) AS duplicate_alias(value);
SELECT left_alias.value, right_alias.value FROM (VALUES (1)) AS left_alias(value), (VALUES (2)) AS right_alias(value);
```

<!-- END SQLSTATE SNIPPET -->

选定的 18.6 与 10.21 运行均通过 SQLSTATE、严重级别、状态/恢复、修复、清理和一次性实例停止断言。详见 [`案例 JSON`](../../data/cases/42712.json) 与 [`作者证据`](../../data/evidence/42712.json)；私有清单和注册表哈希也记录在其中。

## 版本 {#versions}

锁定目录从 7.4 存在边界起包含该条件并列出相关快照。选定自然案例已在 PostgreSQL 18.6 与 10.21 通过；这是有界观察，不能推断所有中间版本或所有源码分支。

## 相关 {#related}

- [`42703`](../42703/)
- [`42725`](../42725/)

## 来源 {#sources}

- `src.errcodes.REL_18_6` — fixed definition at `724edf9bde9d356724ad384a2e196edc3c9f80f7`; SHA-256 `6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba` ([source](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/utils/errcodes.txt#L1-L1)).
- `src.duplicate-alias.18.6` — `src/backend/parser/parse_relation.c` lines 471–474 at `724edf9bde9d356724ad384a2e196edc3c9f80f7`; blob SHA-256 `0d9c88f4a8def4c2d982c33f13208590e21ecf5e6f8cd9d7faa223dc771c9a9a` ([source](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/parser/parse_relation.c#L471-L474)).
- `src.duplicate-alias.10.23` — `src/backend/parser/parse_relation.c` lines 417–420 at `02991e79f8f58bc208f05dcc8af0c62dbe0a6ea4`; blob SHA-256 `a34f40fc93fa5df0015fe5af5ee7761ccba2d16a791cda69ae07848ed27616b5` ([source](https://github.com/postgres/postgres/blob/02991e79f8f58bc208f05dcc8af0c62dbe0a6ea4/src/backend/parser/parse_relation.c#L417-L420)).
- `src.calls.REL_18_6` / `src.calls.REL_10_23` — fixed call scans, SHA-256 `9ee8a0e81d8f0825c5c1ae45583439859a26e602bdd4ce2f2a62aa278867ccbf` / `00d16d3eb01b71ccf1b245c8f3102f9d0ec9f36fb02777b8dd1b99fcb263040c`.
- `manifest.42712` / `snippet-registry.42712` — hashes are recorded in `evidence/42712.json` and each runtime record.