// PostgreSQL 錯誤參考

PostgreSQL 22P02:類型的輸入語法無效

文字值無法轉換成目標型別:把字母塞進整數、格式錯誤的 UUID、壞掉的 JSON、把空字串轉成數字。

SQLSTATE
22P02
名稱
invalid_text_representation
類別
資料異常
錯誤訊息
invalid input syntax for type integer: "abc"

它的意義

PostgreSQL 會使用每種類型的輸入函式將字面值和文字轉換為類型化的值。當文字不是該類型的有效表示時,轉換會以 22P02 失敗,並且訊息會引用引起錯誤的值。

值可能來自查詢中的字面值、繫結參數、 CAST或是被拿去和具型別欄位比較、或插入其中的文字欄位。

常見原因

  • 將數值或 UUID 欄位與既不是數字也不是 UUID 的字串比較,例如 WHERE id = 'abc' 或空字串 ''.
  • 在預期數字的地方傳遞空字串。PostgreSQL 不會將 '' 轉換為 NULL 或 0。
  • 以下輸入內容的格式錯誤: uuid, json/jsonb, boolean, inet 或陣列字面值。
  • 大量 COPY 或 CSV 匯入時,某一列在數字欄位中出現文字。

如何修正

  1. 在轉型(cast)之前,先找出轉不過去的資料列(PostgreSQL 16 及更新版本有 pg_input_is_valid).

    SELECT raw_value
    FROM staging
    WHERE NOT pg_input_is_valid(raw_value, 'integer');
  2. 在較舊的版本上,先以模式篩選,再進行轉型。

    SELECT raw_value::int
    FROM staging
    WHERE raw_value ~ '^-?[0-9]+$';
  3. 將空字串轉換為 NULL 明確指定。

    SELECT NULLIF(trim(raw_value), '')::int FROM staging;
  4. 在應用程式程式碼中,使用正確類型綁定參數,而不是建立 SQL 字串,並在輸入到達資料庫之前驗證輸入。

安全地重現問題

SELECT 'abc'::int;  -- ERROR: invalid input syntax for type integer: "abc"

相關錯誤

更多資料例外狀況錯誤

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

// 錯誤更少,修復更快

在 SQLly 裡操作 PostgreSQL

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