Postgres执行unnest函数报错，应用中却正常运行的原因排查

为什么参数化查询能正常运行？ #

Npgsql在处理UDT（用户自定义类型）参数时做了两个关键优化：

• 强类型参数标记：当你把C#的test_ids类实例数组作为@idpairs参数传递时，Npgsql会自动识别它对应Postgres的ids_test[]类型，在发送请求时给参数带上明确的类型OID（Postgres内部类型标识）。Postgres收到后能直接匹配到对应数组类型的unnest重载，不会出现“function unnest(unknown) is not unique”的歧义。
• 自动维护字段映射：Npgsql会将C#类的属性与Postgres UDT的字段映射关系传递给Postgres，所以unnest(@idpairs)返回的结果集会自动带上UDT定义的列名，不需要手动指定别名。

内联SQL出问题的原因 #

• 直接内联的数组字面量（比如'{(1,2),(3,4)}'）默认被Postgres识别为unknown类型，而unnest有多个重载（支持不同类型的数组），因此会触发歧义错误。
• 即使显式转换为ids_test[]，Postgres虽然能正确调用unnest，但默认返回的列名是f1、f2这类通用命名——这是因为内联SQL没有携带UDT字段的元数据，Postgres只会按字段位置返回列名，而非你定义的字段名。

内联SQL的修复方案 #

如果一定要用内联SQL，需要手动补全两个关键信息：

1. 给数组字面量加上明确的UDT类型转换：

   SELECT * FROM test 
   JOIN unnest('{(1, "val1"), (2, "val2")}'::ids_test[]) AS p 
   ON test.id = p.id
   

2. 手动指定unnest结果的列名（对应UDT的字段名）：

   SELECT * FROM test 
   JOIN unnest('{(1, "val1"), (2, "val2")}'::ids_test[]) AS p(id, value) 
   ON test.id = p.id
   

内容的提问来源于stack exchange，提问作者Vlad Stryapko