Node.js连接PostgreSQL报错：提供2个参数但预准备语句需0个

问题根源 #

PostgreSQL的DO语句属于匿名PL/pgSQL块，外部传入的参数（如$1、$2）无法直接在块内部被识别——块内部的参数作用域是独立的，这就是你传递参数后数据库提示“需要0个参数”，直接执行时提示“没有参数$1”的核心原因。

解决方案：用UPSERT替代DO块 #

PostgreSQL原生支持INSERT ... ON CONFLICT（即UPSERT）语法，可以完美替代原有的IF EXISTS逻辑，同时能正常使用参数绑定：

async function insertUser(user_name, icon_link) {
  await pool.query(
    `INSERT INTO targets(user_name, icon_link, complaints)
     VALUES($1, $2, 0)
     ON CONFLICT(user_name) DO UPDATE 
     SET icon_link = $2, complaints = targets.complaints + 1;`,
    [user_name, icon_link]
  );
}

方案优势 #

• 逻辑和原DO块完全一致：记录存在则更新icon_link并将complaints加1，不存在则插入新记录
• 属于标准SQL语句，非PL/pgSQL块，外部传入的$1、$2能被数据库正确识别并绑定
• 性能更优，无需额外的PL/pgSQL块执行开销

无效方法说明 #

1. 传入配置对象：问题本质不是传参方式，而是DO块无法识别外部参数，因此无论怎么调整传参格式都无法解决
2. 给参数加单引号：这会将$1、$2视为字符串字面量，不仅无法绑定变量，还会引入SQL注入风险

额外注意事项 #

若你的targets表未给user_name字段设置唯一约束，需先执行以下SQL创建约束，否则ON CONFLICT逻辑会失效：

ALTER TABLE targets ADD CONSTRAINT unique_target_user_name UNIQUE(user_name);

内容的提问来源于stack exchange，提问作者7p4