跳转到主要内容

22P05 — untranslatable_character

PostgreSQL SQLSTATE 22P05 的来源与诊断参考。

22P05

速览

PostgreSQL 能识别源字符，却无法在目标编码中表示它。固定辅助函数 以 ERROR 发出 character with byte sequence %s in encoding "%s" has no equivalent in encoding "%s"，其中包含字节序列和两种编码名。

字段 值
SQLSTATE 22P05
条件名 untranslatable_character
状态 有效
已知存在于 7.4
锁定快照 9.0.23, 9.1.24, 9.2.24, 9.3.25, 9.4.26, 9.5.25, 9.6.24, 10.23, 11.22, 12.22, 13.23, 14.24, 15.19, 16.15, 17.11, 18.6, 19beta3
宏 ERRCODE_UNTRANSLATABLE_CHARACTER
别名 —

含义

report_untranslatable_char(src_encoding, dest_encoding, ...) 计算源多字节字符长度，把问题字节格式化为 0x..，当目标转换表没有等价字符时抛出 22P05。也就是说源字符已经足够合法、可以识别，但目标表示无法承载它。它不同于坏源字节：固定转换循环可以调用 report_invalid_encoding，后者使用 22021。

报文

  • ERROR 主消息：character with byte sequence %s in encoding "%s" has no equivalent in encoding "%s"
  • 固定调用没有 DETAIL 或 HINT。

诊断

读取主消息中的字节序列、源编码、目标编码和转换方向。检查 client_encoding、服务器/数据库编码、导入或 COPY 文件编码及实际转换边界。不能仅因字符是非 ASCII 就认定是 22P05；坏源字节和普通类型输入失败走不同路径。

处理

选择能够表示数据的目标编码，或修正生产端和转换边界，同时保留该字符。除非业务明确允许有损处理，不要静默替换或丢弃。引用路径是 ERROR：显式事务中重试前执行 ROLLBACK 或 ROLLBACK TO SAVEPOINT；自动提交模式下修正编码或输入后重新提交。该源码路径不表示 FATAL 或必须重置连接。

版本

锁定目录从 PostgreSQL 7.4 记录此条件。引用的报告辅助函数 和代表性转换分支来自 PostgreSQL 18.6 REL_18_6；本次没有运行编码转换案例。

22021、22P02

来源

src/backend/utils/mb/mbutils.c#L1862-L1902

src/backend/utils/mb/conv.c#L674-L684

结构化证据记录保存精确主消息以及合法字符/坏字节边界。