// PostgreSQL 錯誤參考

PostgreSQL 42P02:缺少參數

SQL 含有 $1 格式的預留位置,但沒有繫結對應的參數值,通常是直接執行驅動程式 SQL,或是引號內出現預留位置所造成。

SQLSTATE
42P02
名稱
undefined_parameter
類別
語法錯誤或存取規則違反
錯誤訊息
there is no parameter $1

它的意義

PostgreSQL 自己的佔位符是 $1, $2 等等,會在陳述式準備或以繫結參數執行時填入。如果文字包含 $1 但語句送出時沒有帶參數,PostgreSQL 無值可代入,便以 42P02 失敗(undefined_parameter).

這通常表示有人手動執行了從應用程式程式碼或日誌複製來的 SQL,或是驅動程式把含預留位置的查詢字串,送進了不會繫結這些預留位置的路徑。

常見原因

  • 在 psql 或 SQL 編輯器中執行從程式碼或記錄中複製的參數化查詢。
  • 位於字串內或 dollar-quoted 函式主體內的預留位置,驅動程式不會替換這些預留位置。
  • A DO 區塊或動態 SQL,配合 $1 沒有 EXECUTE ... USING.
  • 混用不同驅動程式的預留位置樣式: ? 或 %s 在一個地方, $1 在另一個地方。

如何修正

  1. 手動執行時,將佔位符取代為字面值,或者使用 PREPARE 和 EXECUTE.

    PREPARE find_order(int) AS SELECT * FROM orders WHERE id = $1;
    EXECUTE find_order(42);
  2. 在 PL/pgSQL 的動態 SQL 中,傳遞值時請使用 USING.

    DO $$
    DECLARE n int;
    BEGIN
        EXECUTE 'SELECT count(*) FROM orders WHERE customer_id = $1' INTO n USING 42;
        RAISE NOTICE '%', n;
    END;
    $$;
  3. 在應用程式程式碼中,請透過驅動程式的參數 API 傳遞值,而不是將它們串接起來。

安全地重現問題

SELECT $1;  -- ERROR: there is no parameter $1

相關錯誤

更多語法錯誤或存取規則違規錯誤

程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 PostgreSQL

適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。