// 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. 在转换之前先找出无法转换的行(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 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。