// 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 主體,請使用 dollar quoting,這樣主體內的引號就不會提前結束字串。

    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 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。