使用sqlx NamedExec执行PostgreSQL ON CONFLICT时参数不匹配问题

错误原因 #

你遇到的pg: got 6 parameters but the statement requires 4错误，本质是sqlx对命名参数的处理逻辑导致的：
sqlx会将SQL语句中所有出现的命名参数都单独计数，哪怕参数名重复。你的语句里:number和:age各出现了2次，:name和:address各1次，总共生成6个参数占位符；但PostgreSQL解析这条语句时，实际只需要4个唯一参数（重复参数可以复用占位符），因此出现参数数量不匹配的冲突。

另外你的UPDATE子句里还存在字段与值的对应错误：SET (name, address) = (:age, :number)明显不符合业务逻辑（把age赋值给name，number赋值给address），这大概率是笔误，需要先确认你的实际更新需求。

正确解决方案 #

方案1：使用PostgreSQL的EXCLUDED关键字（推荐） #

这是PostgreSQL处理ON CONFLICT的最佳实践，EXCLUDED代表VALUES子句中准备插入的行数据，直接引用它可以避免重复传递参数，同时让语义更清晰。

比如你需要在冲突时更新address和age为新传入的值，修正后的代码如下：

query := `INSERT INTO table_name (name, number, address, age)
  VALUES (:name, :number, :address, :age) 
  ON CONFLICT (name, number) 
  DO UPDATE SET 
    address = EXCLUDED.address,
    age = EXCLUDED.age`
_, err := db.NamedExec(query, records)

如果需要更新其他逻辑（比如合并现有数据），可以结合目标表的别名操作：

query := `INSERT INTO table_name (name, number, address, age)
  VALUES (:name, :number, :address, :age) 
  ON CONFLICT (name, number) 
  DO UPDATE SET 
    address = table_name.address || ', ' || EXCLUDED.address, -- 合并地址
    age = GREATEST(table_name.age, EXCLUDED.age) -- 保留较大的年龄`
_, err := db.NamedExec(query, records)

方案2：手动处理重复参数（不推荐） #

如果必须重复使用命名参数，需要让sqlx将重复的参数名映射到同一个占位符。可以通过sqlx.Named先将命名查询转换为普通查询和参数列表，再手动调整参数，但这种方式繁琐且容易出错，不如EXCLUDED简洁可靠。

注意事项 #

• 冲突列(name, number)是唯一约束/主键的情况下，不建议在DO UPDATE中修改这两个字段，否则可能违反约束规则。
• 确保你的records结构体字段名与SQL中的命名参数完全匹配（或者通过db标签指定映射关系，比如db:"name"）。

内容的提问来源于stack exchange，提问作者Will Robson