42725 ambiguous_function

速览

42725 是 ambiguous_function（函数调用歧义）：有多个可行候选却无法选出最佳候选。案例定义 uuid/jsonb 重载并传入未知类型字符串。

含义

重载解析考虑字面量类型、cast、模式可见性和签名。unknown 让两个候选都可行，报告 function %s is not unique；它不同于定义冲突 42723 和无候选的 42883。检查可见 pg_proc 与参数类型。

诊断

在 pg_proc 中列出可见候选、identity arguments 和输入类型，并检查字面量推断类型。限定模式只能缩小可见范围，不能在重载之间自动选择。

处理

转换为符合业务含义的类型，或删除非预期重载。这里用 ::uuid 选择 UUID。不要只为消除报错而加 cast，因为它可能改变校验与重载行为。显式事务中的歧义会使事务进入 INERROR，应先回滚或回到合适的 savepoint 再重试；本案例的自动提交会话保持 IDLE。

实测诊断

固定组是 ERROR：function %s is not unique，提示为 Could not choose a best candidate function. You might need to add explicit type casts.

代表案例

注册表创建两个重载，用未知字符串触发，再显式 UUID cast 并断言返回值。

CREATE FUNCTION syntax_schema.ambiguous_function(uuid) RETURNS text LANGUAGE SQL AS 'SELECT ''uuid''';
CREATE FUNCTION syntax_schema.ambiguous_function(jsonb) RETURNS text LANGUAGE SQL AS 'SELECT ''jsonb''';
SELECT syntax_schema.ambiguous_function('123e4567-e89b-12d3-a456-426614174000');
SELECT syntax_schema.ambiguous_function('123e4567-e89b-12d3-a456-426614174000'::uuid);

选定的 18.6 与 10.21 运行均通过 SQLSTATE、严重级别、状态/恢复、修复、清理和一次性实例停止断言。详见 案例 JSON 与 作者证据；私有清单和注册表哈希也记录在其中。

版本

锁定目录从 7.4 存在边界起包含该条件并列出相关快照。选定自然案例已在 PostgreSQL 18.6 与 10.21 通过；这是有界观察，不能推断所有中间版本或所有源码分支。

相关

• 42723
• 42883

来源

• 上游源码 src/backend/parser/parse_func.c 第 499–506 行 REL_10_23 02991e79f f1b4af88
• 上游源码 src/backend/parser/parse_func.c 第 570–577 行 REL_18_6 724edf9bd 48314eab
• 上游源码 src/backend/utils/errcodes.txt REL_18_6 724edf9bd 6e8de346
• 核验材料 verify/cases/42725/cases.json f30aa790
• 核验材料 verify/cases/42725/snippets.json 12b590e1
• 核验材料 raw/calls/REL_10_23.jsonl 00d16d3e
• 核验材料 raw/calls/REL_18_6.jsonl 9ee8a0e8