# 42702 — 列引用歧义（ambiguous_column）

> PostgreSQL SQLSTATE 42702（列引用歧义，ambiguous_column）的源码证据、诊断与处理参考。
---

# 42702 — 列引用歧义

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

SQLSTATE `42702` 是 Class `42` 中的 **ambiguous_column**。`42702` 表示列引用歧义。选定 join 使用两个真实表的 `id`，未限定的 `SELECT id` 报告 `column reference "%s" is ambiguous`。

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

| 字段 | 值 |
| --- | --- |
| SQLSTATE | `42702` |
| 条件名 | `ambiguous_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_AMBIGUOUS_COLUMN` |
| 别名 | `—` |

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

## 含义 {#meaning}

`42702` 表示列引用歧义。在 `colNameToVar` 中，PostgreSQL 会扫描当前可见 namespace 的未限定名称。如果同一次查找中有两个可见 range-table 条目都匹配，就会在执行前以 `ERROR` 发出 `column reference "%s" is ambiguous`；选定 join 的两张真实表都暴露了 `id`。这个分支属于名称解析，行值是否相同不能消除歧义。

## 诊断 {#diagnosis}

检查别名、CTE、连接输入、lateral 可见性，以及当前查询范围内提供该名称的每个关系。即使两列值相同，未限定名称仍可能有歧义，因为 PostgreSQL 必须先解析来源再执行查询。这是解析阶段的名称解析，因此选定自动提交会话仍为 `IDLE`；它不同于没有匹配列的 42703。显式事务仍遵循语句级 ERROR 的通常事务状态规则。

## 处理 {#response}

使用稳定的表别名限定预期列（或从范围中移除非预期关系），然后核对返回行。不要依赖连接顺序或相同值“解决”歧义。如果生成 SQL 会引入别名或 CTE，应把限定写进查询构造器契约，并测试选定的来源列。

## 报文 {#messages}

选定的 `parse_relation.c` 分支以明确的 `ERROR` 发出主报文 `column reference "%s" is ambiguous`；`%s` 是未解析的列名，解析位置随语句上下文变化。只有客户端异常而没有服务器 SQLSTATE 和主报文时，不能据此认定 `42702`。

## 代表案例 {#case}

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

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

```sql
CREATE TABLE syntax_schema.left_table (id integer);
CREATE TABLE syntax_schema.right_table (id integer);
INSERT INTO syntax_schema.left_table VALUES (1);
INSERT INTO syntax_schema.right_table VALUES (1);
SELECT id FROM syntax_schema.left_table, syntax_schema.right_table;
SELECT syntax_schema.left_table.id FROM syntax_schema.left_table, syntax_schema.right_table;
```

<!-- END SQLSTATE SNIPPET -->

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

## 版本 {#versions}

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

## 相关 {#related}

- [`42703` — 未定义列](../42703/)
- [`42601` — 语法错误](../42601/)

## 来源 {#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.ambiguous-column.18.6` — `src/backend/parser/parse_relation.c` at `REL_18_6` commit `724edf9bde9d356724ad384a2e196edc3c9f80f7`; fixed blob SHA-256 `0d9c88f4a8def4c2d982c33f13208590e21ecf5e6f8cd9d7faa223dc771c9a9a` ([source](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/parser/parse_relation.c#L960-L964)).
- `src.ambiguous-column.10.23` — `src/backend/parser/parse_relation.c` at `REL_10_23` commit `02991e79f8f58bc208f05dcc8af0c62dbe0a6ea4`; fixed blob SHA-256 `a34f40fc93fa5df0015fe5af5ee7761ccba2d16a791cda69ae07848ed27616b5` ([source](https://github.com/postgres/postgres/blob/02991e79f8f58bc208f05dcc8af0c62dbe0a6ea4/src/backend/parser/parse_relation.c#L787-L791)).
- `src.calls.REL_18_6` / `src.calls.REL_10_23` — fixed call scans, SHA-256 `9ee8a0e81d8f0825c5c1ae45583439859a26e602bdd4ce2f2a62aa278867ccbf` / `00d16d3eb01b71ccf1b245c8f3102f9d0ec9f36fb02777b8dd1b99fcb263040c`.