Postgres JS绑定预编译语句无法识别参数问题求助

这个坑我之前踩过好几次！你遇到的bind message supplies 12 parameters, but prepared statement "prospects-multi-update" requires 0错误，核心原因是PostgreSQL的预编译语句没办法直接识别你写在VALUES子句里的$1到$12占位符——本质上是你的写法把所有参数打包成了一个静态的VALUES块，数据库解析预编译语句时，没有把这些内部的$n当成需要绑定的参数，所以才会认为语句需要0个参数，但你实际传了12个，就出现了不匹配。

下面给你两种靠谱的解决方案，都是我实际项目里用过的：

方案1：用数组+unnest实现批量更新（固定3个参数） #

这种方式把同类型的字段打包成数组，用unnest拆分成行，预编译语句能正确识别占位符，而且不管更新多少行，参数数量都是固定的，扩展性很强：

WITH new_values (id, data, email) AS (
  SELECT 
    unnest($1::int[]), 
    unnest($2::jsonb[]), 
    unnest($3::text[])
)
UPDATE prospects
SET data = new_values.data, email = new_values.email
FROM new_values
WHERE prospects.id = new_values.id
RETURNING *;

使用时，你只需要传递三个数组参数：

• $1：所有要更新的id组成的数组，比如[1,2,3,4]
• $2：对应每个id的data值数组，比如['{"key":"val1"}','{"key":"val2"}',...]
• $3：对应每个id的email值数组，比如['a@example.com','b@example.com',...]

⚠️ 注意：三个数组的长度必须完全一致，否则unnest会导致数据错位。

方案2：用jsonb_to_recordset传递JSON数组（固定1个参数） #

如果觉得数组拆分麻烦，可以把所有更新数据打包成一个JSON数组，用jsonb_to_recordset解析成表结构，这种方式更直观，参数只有1个：

WITH new_values AS (
  SELECT * FROM jsonb_to_recordset($1) 
  AS x(id int, data jsonb, email text)
)
UPDATE prospects
SET data = new_values.data, email = new_values.email
FROM new_values
WHERE prospects.id = new_values.id
RETURNING *;

使用时，传递一个包含所有更新对象的JSON数组参数即可，比如：

[
  {"id":1,"data":{"key":"val1"},"email":"a@example.com"},
  {"id":2,"data":{"key":"val2"},"email":"b@example.com"},
  {"id":3,"data":{"key":"val3"},"email":"c@example.com"},
  {"id":4,"data":{"key":"val4"},"email":"d@example.com"}
]

这种方式不需要担心数组长度匹配的问题，而且JSON结构可读性更强，适合复杂字段的批量更新。

为什么原来的写法会报错？ #

当你创建预编译语句prospects-multi-update时，PostgreSQL解析SQL时，会把VALUES ($1, $2, $3), ($4, $5, $6)...整个当成一个VALUES构造器的内容，但它不会把构造器内部的$n当成预编译语句的参数占位符——或者说你的客户端驱动没有正确地将这些占位符注册到预编译语句中，导致数据库认为这个语句不需要任何参数，但你实际传递了12个参数，最终触发了参数数量不匹配的错误。

内容的提问来源于stack exchange，提问作者Emrys Myrooin