Golang sqlx.DB.Select()绑定变量报错：语句需0个参数

这问题我踩过好几次坑，本质就是你的SQL语句和传入的绑定变量不匹配——要么SQL里根本没留占位符，要么用错了PostgreSQL要求的占位符格式，导致PQ驱动认为你多传了参数。

常见原因及解决方案 #

1. SQL语句里没有占位符，但你传了变量

比如你写了硬编码的SQL，却画蛇添足传了变量：

// 错误示例：SQL里已经写死了id=123，却还传了userID变量
var users []User
err := sqlx.Select(&users, db, "SELECT * FROM users WHERE id = 123", userID)

PQ会直接报错，因为这条SQL不需要任何参数，但你给了一个。

解决办法：要么去掉多余的变量，要么把硬编码的值换成PostgreSQL的占位符$1：

// 正确示例：用$1占位符对应传入的userID
var users []User
err := sqlx.Select(&users, db, "SELECT * FROM users WHERE id = $1", userID)

2. 用错了占位符格式

PostgreSQL不支持MySQL的?或者其他数据库的占位符，它用的是$1、$2这种位置编号占位符。如果你习惯了其他数据库的写法，比如：

// 错误示例：用了MySQL风格的?占位符
err := sqlx.Select(&users, db, "SELECT * FROM users WHERE id = ?", userID)

虽然sqlx有一定的适配能力，但如果配置不对，PQ驱动会识别不到占位符，依然认为语句不需要参数，进而报错。

解决办法：统一换成PostgreSQL的$N格式，N是参数的位置序号（从1开始）。如果是多个参数，依次对应：

// 正确示例：多个参数用$1、$2对应
err := sqlx.Select(&users, db, "SELECT * FROM users WHERE id = $1 AND name = $2", userID, userName)

3. 命名参数使用不当

如果你用sqlx的命名参数功能（比如:user_id），要确保sqlx能正确将其转换为PostgreSQL的$N占位符。比如：

// 正确示例：使用命名参数
var users []User
params := map[string]interface{}{"user_id": userID}
err := sqlx.Select(&users, db, "SELECT * FROM users WHERE id = :user_id", params)

这里sqlx会自动把:user_id转换成$1，并对应传入的userID，参数数量匹配就不会报错。

4. 使用sqlx.In时的坑

如果用sqlx.In处理IN查询，要记得它会把占位符展开成多个$N，必须用返回的args参数去传值：

// 正确示例：sqlx.In的正确用法
ids := []int{1, 2, 3}
query, args, err := sqlx.In("SELECT * FROM users WHERE id IN (?)", ids)
if err != nil {
    // 处理错误
}
// 这里query会变成"SELECT * FROM users WHERE id IN ($1,$2,$3)"，args是[1,2,3]
err = sqlx.Select(&users, db, query, args...)

如果直接把原SQL和ids传进去，就会出现参数数量不匹配的问题。

总结 #

核心原则就是：SQL语句中的占位符数量、格式必须和传入的绑定变量完全对应。PostgreSQL认准$N格式，别混用其他数据库的写法，同时避免传递SQL不需要的多余变量，就能解决这个报错。

内容的提问来源于stack exchange，提问作者Luis Serra