# 22025 — invalid_escape_sequence

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

# 22025

## 速览 {#at-a-glance}
转义序列对具体消费方无效。固定路径区分 LIKE 的 ESCAPE 参数既非空也非单字符、LIKE pattern 以转义字符结束、正则翻译器的转义参数长度规则，以及格式错误的 `\u`/`\U` Unicode 转义。

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

| 字段 | 值 |
| --- | --- |
| SQLSTATE | `22025` |
| 条件名 | `invalid_escape_sequence` |
| 状态 | `有效` |
| 已知存在于 | `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_INVALID_ESCAPE_SEQUENCE` |
| 别名 | `—` |

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

## 代表性报文 {#messages}
代表性消费方使用以下首要文本和提示：

| 消费方/守卫 | 首要文本和提示 |
| --- | --- |
| LIKE 或 SQL 正则翻译的转义长度 | `invalid escape string`；HINT：`Escape string must be empty or one character.` |
| LIKE pattern 以转义符结尾 | `LIKE pattern must not end with escape character` |
| 扫描器发现格式错误的 Unicode 转义 | `invalid Unicode escape`；HINT：`Unicode escapes must be \uXXXX or \UXXXXXXXX.` |

## 含义 {#meaning}
22025 由消费方自己的转义守卫发出。LIKE 要求 ESCAPE 字符串为空或一个字符，并拒绝以转义字符结尾的 pattern；SQL 正则翻译辅助函数对其转义参数也使用空字符串或单字符规则；核心扫描器对格式错误的 Unicode 转义给出 `\uXXXX`/`\UXXXXXXXX` 提示。这些情况不同于 22019 的转义字符语义和 2200C 的 SIMILAR 分隔符溢出；`regexp_replace` 的 option 或 start/occurrence 参数错误则是 22023 参数校验路径。

## 诊断 {#diagnosis}
先确认消费方再修改反斜杠：LIKE ESCAPE 参数、LIKE pattern、SQL 正则翻译，还是扩展字符串字面量的 Unicode 扫描。检查转义值是否为空字符串或单字符、LIKE pattern 是否以转义符结尾，以及 Unicode 转义是否具备所需 `\u`/`\U` 长度。不要把所有正则替换或 SIMILAR 语法错误都叫作 22025，应以实际 SQLSTATE 和首要报文分类。

## 处理 {#response}
按消费方要求提供转义字符串和 pattern，并保留有意使用的空字符串，不要将其理解为 SQL NULL。Unicode 语法错误应按扫描器要求使用 `\uXXXX` 或 `\UXXXXXXXX`。如果 ERROR 发生在显式事务中，应先 ROLLBACK 或回滚到既有保存点再重试；自动提交可重试修正后的语句。

## 版本 {#versions}
锁定目录从 7.4 起记录该条件；本页固定源码路径为 PostgreSQL 18.6。未声称本页有自然运行观察。

## 相关 {#related}
[`22019`](../22019/)、[`2200C`](../2200c/)、[`22023`](../22023/)

## 来源 {#sources}
LIKE 守卫在 [`src/backend/utils/adt/like_match.c#L159-165`](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/utils/adt/like_match.c#L159) 和 [`#L439-449`](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/utils/adt/like_match.c#L439)；SQL 正则翻译的转义长度守卫见 [`src/backend/utils/adt/regexp.c#L793-805`](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/utils/adt/regexp.c#L793)；格式错误的 Unicode 转义在 [`src/backend/parser/scan.l#L697-704`](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/parser/scan.l#L697)。结构化[证据记录](../../data/evidence/22025.json)保留确切首要报文、提示和消费方边界；本页未运行自然案例。