22P06

速览

SQL 扫描器发现反斜杠转义形式在当前字符串字面量规则下非标准或不安全。PostgreSQL 18.6 有一个不安全引号转义的 ERROR 分支，以及反斜杠-引号、反斜杠-反斜杠和其他转义用法的三个 WARNING 分支。

含义

扫描器把 backslash_quote、escape_string_warning 和 standard_conforming_strings 复制到自身状态。普通带引号字符串只有在 standard_conforming_strings 为 off 时才进入可处理转义的 xe 规则；显式 E'...' 直接进入该规则。显式 E 字符串在进入 xe 时把 warn_on_first_escape 初始化为 false，因此不会触发这组旧式的首次转义 WARNING；但它仍受 backslash_quote 的 ERROR 检查条件约束，E 前缀不是绕过该条件的通用办法。反斜杠后是单引号时，如果 backslash_quote = off，或安全编码模式遇到仅客户端支持的编码（client-only），就以 ERROR 发出主消息 unsafe use of \' in a string literal，并提示使用成对单引号。

当 escape_string_warning 和每个字符串只警告第一次转义的条件打开时，词法器会分别为 \'、\\ 或其他转义每个字符串发出一次 WARNING。精确主消息是 nonstandard use of \' in a string literal、nonstandard use of \\ in a string literal 和 nonstandard use of escape in a string literal。这些是警告诊断，不是 NOTICE，本身不会中止语句。

报文

• ERROR 主消息：unsafe use of \' in a string literal；HINT：Use '' to write quotes in strings. \' is insecure in client-only encodings.
• WARNING 主消息：nonstandard use of \' in a string literal；HINT：Use '' to write quotes in strings, or use the escape string syntax (E'...').
• WARNING 主消息：nonstandard use of \\ in a string literal；HINT：Use the escape string syntax for backslashes, e.g., E'\\'.
• WARNING 主消息：nonstandard use of escape in a string literal；HINT：Use the escape string syntax for escapes, e.g., E'\r\n'.

诊断

保留字面量写法和字符位置、是否有 E 前缀、standard_conforming_strings、backslash_quote、escape_string_warning、客户端编码及消息严重性。ERROR 分支会拒绝当前语句，警告分支可能允许语句继续，因此不能只根据“反斜杠”三个字判断结果。

处理

嵌入单引号时写成连续两个单引号；确实需要反斜杠时使用明确的 E'...' 语法并固定预期转义语义。如果是 ERROR，显式事务已中止，重试前执行 ROLLBACK 或 ROLLBACK TO SAVEPOINT；自动提交模式下先修正字面量。WARNING 不需要事务恢复，但应优先修正字面量，不要靠隐藏警告或全局改策略来掩盖问题。引用路径不要求重置连接。

版本

锁定目录从 PostgreSQL 8.1.0 记录此条件。引用的扫描器检查条件和精确消息来自 PostgreSQL 18.6 REL_18_6；本次没有运行区域设置或 GUC 案例。

相关

22019、42601

来源

src/backend/parser/scan.l#L545-L560

src/backend/parser/scan.l#L706-L720

src/backend/parser/scan.l#L1423-L1459

结构化证据记录保存四个精确主消息、提示、检查条件、严重性和源码/运行边界。