使用SQLx预准备语句从PostgreSQL查询数据的技术咨询

看起来你在Go语言中结合预准备语句查询PostgreSQL的accounts表时遇到了麻烦，虽然用database.Get()能正常返回数据，但切换到预准备语句时可能碰到了问题。我结合你给出的表结构和结构体定义，整理了几个常见的坑和解决办法：

先明确你的基础信息 #

数据库表结构

create table accounts (
    id bigserial not null constraint accounts_pkey primary key,
    identificator text not null,
    password text not null,
    salt text not null,
    type smallint not null,
    level smallint not null,
    created_at timestamp not null,
    updated timestamp not null,
    expiry_date timestamp,
    qr_key text
);

Go结构体定义（补全了缺失的字段）

type Account struct {
    ID             string     `db:"id"`
    Identificator  string     `db:"identificator"`
    Password       string     `db:"password"`
    Salt           string     `db:"salt"`
    Type           int8       `db:"type"`
    Level          int8       `db:"level"`
    CreatedAt      time.Time  `db:"created_at"`
    Updated        time.Time  `db:"updated"`
    ExpiryDate     *time.Time `db:"expiry_date"`
    QRKey          *string    `db:"qr_key"`
}

常见问题与解决方案 #

1. 预准备语句的占位符用错了 #

PostgreSQL的参数占位符是$1、$2这种格式，不是MySQL常用的?，这是最容易踩的坑：

// ❌ 错误写法（用了MySQL风格占位符）
stmt, err := db.Prepare("SELECT * FROM accounts WHERE id = ?")
// ✅ 正确写法
stmt, err := db.Prepare("SELECT * FROM accounts WHERE id = $1")

2. 结构体字段与数据库类型不匹配 #

你的ID字段定义成了string，但数据库里id是bigserial（对应Go的int64类型），这会导致数据解析失败。建议修改结构体：

type Account struct {
    ID             int64      `db:"id"` // 改成int64匹配bigserial类型
    // 其他字段保持不变
}

3. 预准备语句的结果扫描方式不对 #

如果用的是原生database/sql包，预准备语句查询后需要手动扫描每个字段到结构体；如果是sqlx这类带自动映射的库，要注意用对应的Preparex和Get方法：

用sqlx的正确示例

// 预编译带命名映射的语句
stmt, err := db.Preparex("SELECT * FROM accounts WHERE identificator = $1")
if err != nil {
    log.Fatal(err)
}
defer stmt.Close()

var acc Account
// 自动映射到结构体
err = stmt.Get(&acc, "your_test_identificator")
if err != nil {
    if err == sql.ErrNoRows {
        log.Println("账号不存在")
        return
    }
    log.Fatal(err)
}

用原生database/sql的正确示例

stmt, err := db.Prepare("SELECT id, identificator, password, salt, type, level, created_at, updated, expiry_date, qr_key FROM accounts WHERE id = $1")
if err != nil {
    log.Fatal(err)
}
defer stmt.Close()

var acc Account
// 手动扫描每个字段到结构体对应变量
err = stmt.QueryRow(123).Scan(
    &acc.ID,
    &acc.Identificator,
    &acc.Password,
    &acc.Salt,
    &acc.Type,
    &acc.Level,
    &acc.CreatedAt,
    &acc.Updated,
    &acc.ExpiryDate,
    &acc.QRKey,
)
if err != nil {
    if err == sql.ErrNoRows {
        log.Println("账号不存在")
        return
    }
    log.Fatal(err)
}

4. 别忘了捕获并打印错误 #

很多时候问题就藏在错误信息里，比如字段名拼写错误、数据库权限不足、空值处理不当等，一定要把Prepare、QueryRow、Get返回的错误打印出来，能快速定位问题。

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