// 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 导入时某行的数字列中出现了文本。
如何修复它
-
在转换之前先找出无法转换的行(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 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。