# 22P05 — untranslatable_character

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

# 22P05

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

<!-- BEGIN SQLSTATE FACTS: generated by scripts/generate.py; do not edit -->

| 字段 | 值 |
| --- | --- |
| 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` |
| 别名 | `—` |

<!-- source facts: data/errcodes/22P05.json -->
<!-- END SQLSTATE FACTS -->

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

## 报文 {#messages}
- `ERROR` 主消息：`character with byte sequence %s in encoding "%s" has no equivalent in encoding "%s"`
- 固定调用没有 DETAIL 或 HINT。

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

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

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

## 相关 {#related}
[`22021`](../22021/)、[`22P02`](../22p02/)

## 来源 {#sources}
[`src/backend/utils/mb/mbutils.c#L1862-L1902`](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/utils/mb/mbutils.c#L1862)

[`src/backend/utils/mb/conv.c#L674-L684`](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/utils/mb/conv.c#L674)

结构化[证据记录](../../data/evidence/22p05.json)保存精确主消息以及合法字符/坏字节边界。