42703 undefined_column

速览

SQLSTATE 42703 是 Class 42 中的 undefined_column。42703 表示未定义列。选定查询在真实表上引用 missing_column，报告 column "%s" does not exist；改为已定义的 id 后成功。

含义

42703 表示未定义列。当关系已经解析出来、但引用的列不在可见查询范围内时，errorMissingColumn 会在 range table 中寻找有用建议并发出 ERROR：column "%s" does not exist（如果指定了关系，也可能使用限定形式）。选定查询在真实表上引用 missing_column，改为已定义的 id 后成功。

诊断

检查准确关系、别名、解析范围、带引号的拼写/大小写和迁移版本。如果解析器找到接近候选列，可能追加 HINT；选定路径没有 HINT。解析器在执行前报告错误，自动提交会话仍为 IDLE；显式 BEGIN 中会让事务进入 INERROR，必须 ROLLBACK 或回滚到合适保存点后再重试。要把缺列与 42P01（未限定关系不存在）、3F000（schema/创建 namespace 不存在）以及 42702（多个可见列匹配）区分开。

处理

修正列名或迁移后针对预期关系重新执行。如果应用支持多个 schema 或版本，应限定关系并先部署匹配的迁移。带引号且大小写不同的标识符是不同名称；修改应用 SQL 前应通过目录或 introspection 确认已部署的拼写。

报文

选定的 errorMissingColumn 分支以明确的 ERROR 发出主报文 column "%s" does not exist；%s 是未解析列名，其他源码分支可能追加建议 HINT 或使用带关系限定的形式。只有客户端异常而没有服务器 SQLSTATE 和主报文时，不能据此认定 42703。

代表案例

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

CREATE TABLE syntax_schema.column_table (id integer);
INSERT INTO syntax_schema.column_table VALUES (1);
SELECT missing_column FROM syntax_schema.column_table;
SELECT id FROM syntax_schema.column_table;

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

版本

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

相关

• 42702 — 列引用歧义
• 3F000 — 相关条件

来源

• 上游源码 src/backend/utils/errcodes.txt REL_18_6 724edf9bd 6e8de346
• 上游源码 src/backend/parser/parse_relation.c 第 3327–3331 行 REL_10_23 02991e79f a34f40fc
• 上游源码 src/backend/parser/parse_relation.c 第 3854–3859 行 REL_18_6 724edf9bd 0d9c88f4
• 核验材料 verify/cases/42703/cases.json 8034d100
• 核验材料 verify/cases/42703/snippets.json c272ed58
• 核验材料 raw/calls/REL_10_23.jsonl 00d16d3e
• 核验材料 raw/calls/REL_18_6.jsonl 9ee8a0e8