Go queryrow 怎么处理单行结果

用 Go 的 database/sql 查一条记录时，很多人会把错误判断写在 QueryRow 后面。这里要先记住一个关键点：QueryRow 返回的是非 nil 的 *sql.Row，真正的查询错误、无匹配行和字段转换错误，都会在调用 Scan 时暴露。只要把 Scan 的返回值处理完整，单行读取就不会把“没有数据”误报成数据库故障。

先把 QueryRow 的返回链路看完整

QueryRow 本身不返回 error，所以不能写成“调用 QueryRow 后立即判断错误”。它先把查询动作包装成一个 *sql.Row，随后由 Scan 完成读取。查询没有结果时，Scan 返回 sql.ErrNoRows；如果结果超过一行，也不会自动报错，而是使用第一行并丢弃其余行。

因此，最小心智模型是：QueryRow 负责表达“我最多要一行”，Row 保存延迟到 Scan 的结果状态，Scan 才是读取和报错的落点。

Scan 才是读取与转换的落点

下面的函数查询用户的三列数据。示例故意把可空的邮箱声明为 sql.NullString，这样数据库中的 NULL 不会直接塞进普通 string 导致转换失败。

package userrepo

import (
    "context"
    "database/sql"
    "errors"
    "fmt"
)

type User struct {
    ID    int64
    Name  string
    Email sql.NullString
}

func findUser(ctx context.Context, db *sql.DB, id int64) (User, error) {
    var user User

    // 使用带上下文的单行查询，让请求取消信号能够传给数据库驱动。
    err := db.QueryRowContext(ctx,
        "SELECT id, name, email FROM users WHERE id = ?", id,
    ).Scan(&user.ID, &user.Name, &user.Email)
    if err != nil {
        // 无匹配行是业务分支，不应和连接、SQL 或转换故障混在一起。
        if errors.Is(err, sql.ErrNoRows) {
            return User{}, fmt.Errorf("user %d not found: %w", id, err)
        }
        // %w 保留底层错误，调用方仍可用 errors.Is/As 继续判断。
        return User{}, fmt.Errorf("query user %d: %w", id, err)
    }
    return user, nil
}

这里的列顺序是 id, name, email，所以 Scan 的三个目标也必须按同样顺序排列。驱动的占位符可能不是 ?，例如某些 PostgreSQL 驱动使用 $1；这属于驱动语法差异，不改变 QueryRow 的错误边界。

把三类错误分开处理

判断无数据时优先使用 errors.Is(err, sql.ErrNoRows)，不要只比较错误字符串。这样即使中间增加了带上下文的错误包装，调用方仍能识别原始错误。对于可空列，除了 sql.NullString，还可以按字段类型选择 sql.NullInt64、sql.NullBool 或 sql.NullTime。

用五项检查复查单行读取函数

1. 查询条件是否真的保证业务上最多返回一条；若需要发现重复数据，应在数据库层加唯一约束，而不是依赖 QueryRow 静默取第一行。
2. SELECT 列顺序和 Scan 目标顺序是否一一对应。
3. 可能为 NULL 的列是否使用了合适的可空类型。
4. 是否只在 Scan 后判断错误，并用 errors.Is 区分 sql.ErrNoRows。
5. 请求链路是否使用 QueryRowContext，避免上游取消后查询仍失去上下文。

相关问题

QueryRow 没查到数据会返回 nil 吗？

不会。QueryRow 返回非 nil 的 *sql.Row，无数据要到 Scan 时通过 sql.ErrNoRows 判断。

QueryRow 查出多行会报错吗？

不会自动因为多行报错，Scan 使用第一行并丢弃其余结果。需要唯一性时应让条件或数据库约束表达出来。

为什么不能把 NULL 扫描到 string？

普通 string 没有“是否为 NULL”的状态。数据库列允许 NULL 时，使用 sql.NullString 并检查它的 Valid 字段更稳妥。