// PostgreSQL 錯誤參考
PostgreSQL 22P02:類型的輸入語法無效
文字值無法轉換成目標型別:把字母塞進整數、格式錯誤的 UUID、壞掉的 JSON、把空字串轉成數字。
- SQLSTATE
22P02- 名稱
invalid_text_representation- 類別
- 資料異常
它的意義
PostgreSQL 會使用每種類型的輸入函式將字面值和文字轉換為類型化的值。當文字不是該類型的有效表示時,轉換會以 22P02 失敗,並且訊息會引用引起錯誤的值。
值可能來自查詢中的字面值、繫結參數、 CAST或是被拿去和具型別欄位比較、或插入其中的文字欄位。
常見原因
- 將數值或 UUID 欄位與既不是數字也不是 UUID 的字串比較,例如
WHERE id = 'abc'或空字串''. - 在預期數字的地方傳遞空字串。PostgreSQL 不會將
''轉換為NULL或 0。 - 以下輸入內容的格式錯誤:
uuid,json/jsonb,boolean,inet或陣列字面值。 - 大量
COPY或 CSV 匯入時,某一列在數字欄位中出現文字。
如何修正
-
在轉型(cast)之前,先找出轉不過去的資料列(PostgreSQL 16 及更新版本有
pg_input_is_valid).SELECT raw_value FROM staging WHERE NOT pg_input_is_valid(raw_value, 'integer');
-
在較舊的版本上,先以模式篩選,再進行轉型。
SELECT raw_value::int FROM staging WHERE raw_value ~ '^-?[0-9]+$';
-
將空字串轉換為
NULL明確指定。SELECT NULLIF(trim(raw_value), '')::int FROM staging;
-
在應用程式程式碼中,使用正確類型綁定參數,而不是建立 SQL 字串,並在輸入到達資料庫之前驗證輸入。
安全地重現問題
SELECT 'abc'::int; -- ERROR: invalid input syntax for type integer: "abc"
相關錯誤
22003數值超出範圍22007無效的日期時間格式42804資料類型不符22021編碼的位元組序列無效245SQL Server:轉換值時失敗1366MySQL:欄位的值不正確ORA-01722Oracle:無效的數字
更多資料例外狀況錯誤
程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.
// 錯誤更少,修復更快
在 SQLly 裡操作 PostgreSQL
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。