22P02 invalid_text_representation

速览

22P02 表示文本输入例程无法把值解释为目标类型。本页选择普通整数输入路径，同时标出 COPY/文本边界；COPY、枚举、扩展和 contrib 调用可能使用不同主报文。

含义

cast、赋值或文本 COPY 字段由目标类型的输入例程判断文本是否合法。PostgreSQL 18.6 使用 invalid input syntax for type integer: "%s"，锁定的 PostgreSQL 10.23 源码使用 invalid input syntax for integer: "%s"；两者都是动态模板，也不是统一的本地化字符串。其他固定调用者还包括 COPY reject-limit、枚举输入和扩展校验，因此 primary 文本和上下文可能不同。

诊断

记录目标类型、客户端编码和参数绑定后的原始值，并确认操作是 cast、赋值、文本 COPY 字段、枚举输入还是其他类型包装。把坏文本（22P02）与数值越界（22003）、日期时间语法错误（22007）、二进制表示无效（22P03）以及 COPY 文件/头部或 framing 错误（22P04）区分开。二进制 COPY payload 不能只按文本输入报文诊断。

处理

在输入边界校验并保持预期目标类型。只有修正值后才重试；除非业务规则明确要求，不要静默截断或把值变成 NULL。显式事务中的输入 ERROR 会使事务进入中止状态（25P02）；继续前执行 ROLLBACK，或使用 ROLLBACK TO SAVEPOINT convert_input。COPY 出错后也必须先恢复事务，再执行下一条命令。

实测诊断

普通整数路径固定为 ERROR，并有上述版本差异的动态主报文。选定实测记录了精确值："not-an-integer" 产生 22P02，同一自动提交会话随后把合法 "42" 转换为 42。

代表案例

共享注册表在自动提交下先发送一次无效文本 cast，检查真实诊断和 IDLE 状态，再在同一连接发送合法整数文本。这个实测恢复不同于显式事务；后者必须先回滚或回滚到保存点。页面 SQL 与运行器来自同一注册表，没有隐藏的第二定义。

SELECT 'not-an-integer'::integer;
SELECT '42'::integer

选定的 PostgreSQL 18.6 与 10.21 运行均通过 SQLSTATE、严重级别、状态或断开恢复、修复、清理和一次性实例停止断言。详见 案例 JSON 与 作者证据。

版本

锁定目录从 7.4 起记录 22P02。18.6 与 10.21 的有界运行均通过，但主报文措辞如上有所不同；这不能推广到所有 22P02 调用方或所有中间版本。

相关

• 22003
• 22007
• 22P03
• 22P04

来源

• 上游源码 src/backend/utils/errcodes.txt 第 206 行 REL_18_6 724edf9bd 6e8de346
• 上游源码 src/backend/utils/adt/numutils.c 第 59–62 行 REL_10_23 02991e79f 6cb3fd7e
• 上游源码 src/backend/utils/adt/numutils.c 第 614–618 行 REL_18_6 724edf9bd 9018d559
• 上游源码 src/backend/commands/copyfrom.c 第 1169 行 REL_18_6 724edf9bd 2eacfb8e
• 上游源码 contrib/file_fdw/file_fdw.c 第 799 行 REL_18_6 724edf9bd d79ec21c
• 上游源码 contrib/isn/isn.c 第 409 行 REL_18_6 724edf9bd 5dcd8ac5
• 上游源码 src/backend/commands/extension.c 第 1366 行 REL_18_6 724edf9bd e31879ca
• 核验材料 verify/cases/22P02/cases.json 00983166
• 核验材料 verify/cases/22P02/snippets.json 887c8b09
• 核验材料 raw/calls/REL_10_23.jsonl REL_10_23 00d16d3e
• 核验材料 raw/calls/REL_18_6.jsonl REL_18_6 9ee8a0e8