22021

速览

源字节序列对于正在检查的编码无效。固定转换路径报告 invalid byte sequence for encoding "%s": %s，并以十六进制列出违规字节。

含义

report_invalid_encoding 计算不完整或无效多字节序列的长度，使用源编码名和十六进制字节发出 22021。有效的源字符若在目标编码中没有等价表示，则走独立的 22P05 untranslatable-character 路径；这不表示源字节本身损坏。

诊断

在改动前记录源/目标编码、客户端/数据库设置以及原始字节。无效源字节指向输入或边界解码问题；可读但不可表示的字符指向目标编码的字符表示范围。不要把 SQL_ASCII 当作无条件修复：接受任意字节可能只是推迟或隐藏编码边界缺陷。

处理

修复生产端或编码边界，或在保留违规字节的前提下按明确的丢弃/拒绝策略显式转换。如果 ERROR 发生在显式事务中，应先 ROLLBACK 或回滚到既有保存点再重试；自动提交可重试修正后的输入。

版本

锁定目录从 7.4 起记录该条件；本页固定转换路径为 PostgreSQL 18.6。未声称本页有自然运行观察。

相关

22P05、22018

来源

无效字节报告器在 src/backend/utils/mb/mbutils.c#L1818-1853；同一固定文件的 report_untranslatable_char 路径对有效但不可表示字符发出独立 22P05。结构化证据记录保留两条边界；本页未运行自然案例。