42P21 collation_mismatch

速览

42P21（collation_mismatch）需要得到兼容结果时，不同排序规则选择可能发生冲突。

含义

当固定源码路径需要一个兼容的排序规则，却得到不兼容的选择时，会报 42P21。隐式选择会先记录为 COLLATE_CONFLICT；调用方允许没有共同排序规则时可以返回 InvalidOid，只有确实需要排序规则的调用方才把隐式冲突变成 ERROR。显式 COLLATE 冲突则立即失败。同一条件还覆盖递归 CTE 输出、继承或子表列定义，以及外键键列兼容性。

诊断

遇到隐式排序规则消息时保留两个名称，并检查调用方是否要求共同排序规则；不同的隐式操作数不会全部立即抛出 42P21。遇到显式排序规则消息时，找出两个 COLLATE 子句并统一预期选择。递归查询要比较非递归项与整体列排序规则。继承或分区子表错误要比较父表与子表列定义。外键要比较引用表和被引用表的键列：固定源码允许两边都是确定性排序规则时使用不同排序规则；只要任一排序规则不确定，两边就必须相同。保留 DETAIL 中的名称，不要把它笼统当成转成 text 就能解决的问题。

处理

表达式冲突应在表达式边界明确指定一个有意选择的 COLLATE，或统一显式子句及递归非递归项的排序规则。重试 DDL 前先对齐继承列或子表列定义。外键应选择兼容的键列排序规则；只要一侧不确定，就满足两边相同的严格要求，然后重新核对相等比较和索引语义。如果该 ERROR 发生在显式事务中，修正语句前先 ROLLBACK，或回滚到错误前的保存点；自动提交模式下连接回到空闲后再重试。

消息

固定源码中的代表性消息包括：

• ERROR message: collation mismatch between implicit collations "%s" and "%s"; HINT: You can choose the collation by applying the COLLATE clause to one or both expressions.
• ERROR message: collation mismatch between explicit collations "%s" and "%s"
• ERROR message: recursive query "%s" column %d has collation "%s" in non-recursive term but collation "%s" overall; HINT: Use the COLLATE clause to set the collation of the non-recursive term.
• ERROR message: column "%s" has a collation conflict; DETAIL: "%s" versus "%s"
• ERROR message: inherited column "%s" has a collation conflict; DETAIL: "%s" versus "%s"
• ERROR message: child table "%s" has different collation for column "%s"; DETAIL: "%s" versus "%s"
• ERROR message: foreign key constraint "%s" cannot be implemented; DETAIL: Key columns "%s" of the referencing table and "%s" of the referenced table have incompatible collations: "%s" and "%s". If either collation is nondeterministic, then both collations have to be the same.

占位符由实际对象、列或参数填充。

版本

锁定目录显示该条件最早见于 PostgreSQL 9.1.0；行为说明固定在 PostgreSQL 18.6 源码，目录存在范围不等于每条消息或功能都从该版本开始。

相关

• 42P22
• 42P18

来源

• 上游源码 src/backend/commands/tablecmds.c 第 10474–10483 行 REL_18_6 724edf9bd 422dc8e8
• 上游源码 src/backend/parser/parse_collate.c 第 853–858 行 REL_18_6 724edf9bd e92a01d1
• 上游源码 src/backend/commands/tablecmds.c 第 3297–3303 行 REL_18_6 724edf9bd 422dc8e8
• 上游源码 src/backend/commands/tablecmds.c 第 3463–3469 行 REL_18_6 724edf9bd 422dc8e8
• 上游源码 src/backend/parser/parse_collate.c 第 226–232 行 REL_18_6 724edf9bd e92a01d1
• 上游源码 src/backend/parser/parse_cte.c 第 394–401 行 REL_18_6 724edf9bd 908eef14
• 上游源码 src/backend/commands/tablecmds.c 第 7292–7298 行 REL_18_6 724edf9bd 422dc8e8
• 上游源码 src/backend/parser/parse_collate.c 第 208 行 REL_18_6 724edf9bd e92a01d1
• 上游源码 src/backend/utils/errcodes.txt 第 352 行 REL_18_6 724edf9bd 6e8de346
• 核验材料 raw/calls/REL_18_6.jsonl 9ee8a0e8