// PostgreSQL 錯誤參考
PostgreSQL 42P02:缺少參數
SQL 含有 $1 格式的預留位置,但沒有繫結對應的參數值,通常是直接執行驅動程式 SQL,或是引號內出現預留位置所造成。
- SQLSTATE
42P02- 名稱
undefined_parameter
它的意義
PostgreSQL 自己的佔位符是 $1, $2 等等,會在陳述式準備或以繫結參數執行時填入。如果文字包含 $1 但語句送出時沒有帶參數,PostgreSQL 無值可代入,便以 42P02 失敗(undefined_parameter).
這通常表示有人手動執行了從應用程式程式碼或日誌複製來的 SQL,或是驅動程式把含預留位置的查詢字串,送進了不會繫結這些預留位置的路徑。
常見原因
- 在 psql 或 SQL 編輯器中執行從程式碼或記錄中複製的參數化查詢。
- 位於字串內或 dollar-quoted 函式主體內的預留位置,驅動程式不會替換這些預留位置。
- A
DO區塊或動態 SQL,配合$1沒有EXECUTE ... USING. - 混用不同驅動程式的預留位置樣式:
?或%s在一個地方,$1在另一個地方。
如何修正
-
手動執行時,將佔位符取代為字面值,或者使用
PREPARE和EXECUTE.PREPARE find_order(int) AS SELECT * FROM orders WHERE id = $1; EXECUTE find_order(42);
-
在 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; $$; -
在應用程式程式碼中,請透過驅動程式的參數 API 傳遞值,而不是將它們串接起來。
安全地重現問題
SELECT $1; -- ERROR: there is no parameter $1
相關錯誤
更多語法錯誤或存取規則違規錯誤
42501權限遭拒42846無法強制轉換42803欄位必須出現在 GROUP BY 子句中42830無效的外鍵42804資料類型不符42703欄位不存在42883函式不存在42P01關聯不存在
程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.
// 錯誤更少,修復更快
在 SQLly 裡操作 PostgreSQL
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。