42702 ambiguous_column

速览

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

含义

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

诊断

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

处理

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

报文

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

代表案例

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

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;

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

版本

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

相关

• 42703 — 未定义列
• 42601 — 语法错误

来源

• 上游源码 src/backend/parser/parse_relation.c 第 787–791 行 REL_10_23 02991e79f a34f40fc
• 上游源码 src/backend/parser/parse_relation.c 第 960–964 行 REL_18_6 724edf9bd 0d9c88f4
• 上游源码 src/backend/utils/errcodes.txt REL_18_6 724edf9bd 6e8de346
• 核验材料 verify/cases/42702/cases.json 31c6d96b
• 核验材料 verify/cases/42702/snippets.json b8d1edca
• 核验材料 raw/calls/REL_10_23.jsonl 00d16d3e
• 核验材料 raw/calls/REL_18_6.jsonl 9ee8a0e8