// PostgreSQL 错误参考

PostgreSQL 42703:列不存在

查询中的列名在它能看到的表中不存在。通常是拼写错误、大小写混合的名称,或将双引号用于字符串值。

SQLSTATE
42703
名称
undefined_column
类别
语法错误或访问规则违规
错误信息
column "emial" does not exist
LINE 1: SELECT emial FROM users;
               ^
HINT:  Perhaps you meant to reference the column "users.email".

它的意思

PostgreSQL 无法将列引用匹配到 FROM 子句。当存在相似的名称时,较新版本会添加一个 HINT ,并以此作为提示。

这些错误大多源于两条 PostgreSQL 规则。不加引号的标识符会折叠成小写,因此创建时写作 "createdAt" 必须连同引号一起书写。而双引号总是表示标识符,绝不会是字符串,所以 WHERE status = "active" 查找名为 active.

常见原因

  • 拼写错误,或者该列被重命名过或尚未添加。
  • 使用带引号的混合大小写字母创建的列("userId")在未加引号的情况下被引用。
  • 用双引号写的字符串值: WHERE name = "Ada" 代替 'Ada'.
  • 在以下位置引用了选择列表别名 WHERE 或者 GROUP BY 表达式中它都不可见:别名只能用在 ORDER BY (以及作为不带引号的裸名用于 GROUP BY).
  • 使用的表别名指向了错误的表,或者使用了子查询中未选取的列。

如何修复它

  1. 列出表的真实列名。

    SELECT column_name, data_type
    FROM information_schema.columns
    WHERE table_schema = 'public' AND table_name = 'users'
    ORDER BY ordinal_position;
  2. 值用单引号,双引号仅用于标识符。

    SELECT * FROM users WHERE status = 'active';
  3. 按创建时的原样为大小写混合的列名加引号。

    SELECT "userId", "createdAt" FROM events;
  4. 在以下位置重复使用表达式或包裹查询,而不是使用别名 WHERE.

    SELECT * FROM (
        SELECT id, price * qty AS total FROM order_lines
    ) t
    WHERE total > 100;

安全地复现它

CREATE TEMP TABLE users (id int, email text);
SELECT emial FROM users;  -- ERROR: column "emial" does not exist

问题

为什么 WHERE name = "Ada" 会提示列 Ada 不存在?

在 PostgreSQL 中,双引号用于标识符,例如列名或表名。字符串值使用单引号:WHERE name = 'Ada'。

相关错误

更多语法错误或访问规则违例错误

代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。