// PostgreSQL 错误参考

PostgreSQL 42601:在出错位置或其附近出现语法错误

PostgreSQL 无法解析该语句。它指出的标记及其下方的插入符指示了解析失败的位置;真正的问题往往就在它前面。

SQLSTATE
42601
名称
syntax_error
类别
语法错误或访问规则违规
错误信息
syntax error at or near "FROM"
LINE 1: SELECT id, name, FROM users;
                         ^

它的意思

解析器读取语句直到错误消息所指的词元,发现接下来的内容不合语法。 syntax error at end of input 表示语句在还需要更多内容的地方停止了,例如缺少右括号。

该位置是 PostgreSQL 察觉到问题的地方,通常比实际错误晚一个词元:例如某个多余的尾逗号,出现在 FROM,列之间缺少逗号,或使用保留字作为名称。

常见原因

  • 一个尾随逗号出现在 FROM, ) 或者 WHERE,或者列表项之间少了逗号。
  • 保留字未加引号就用作列名或表名,例如 user, order 或者 group.
  • 来自其他数据库的语法: TOP, [brackets],反引号, LIMIT x, y, IFNULL.
  • 括号或引号不配对,在输入结束时就会报错。
  • 客户端占位符(?, :name, %s)不经驱动程序替换直接发送到服务器;PostgreSQL 本身使用 $1, $2.

如何修复它

  1. 查看消息中指出的标记及其前面的那个;删掉多余的逗号或补上缺失的逗号。

    SELECT id, name FROM users;
  2. 将作为标识符的保留字加引号,或重命名它们。

    SELECT "user", "order" FROM audit_log;
  3. 将其他方言的语法重写为 PostgreSQL 形式。

    -- SQL Server: SELECT TOP 10 * FROM [orders]
    SELECT * FROM orders LIMIT 10;
    -- MySQL: LIMIT 20, 10
    SELECT * FROM orders LIMIT 10 OFFSET 20;
  4. 对于 PL/pgSQL 函数体,请使用美元符号引用,这样函数体内的引号就不会终止字符串。

    CREATE FUNCTION greet(name text) RETURNS text
    LANGUAGE plpgsql AS $$
    BEGIN
        RETURN 'Hello, ' || name;
    END;
    $$;

安全地复现它

SELECT id, FROM (VALUES (1)) v(id);  -- ERROR: syntax error at or near "FROM"

相关错误

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

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

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

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