Go database/sqlRows.Next 返回 false 但 Err 为空怎么办

循环没有进去，紧接着检查 rows.Err() 却得到 nil，这两个现象并不矛盾。Rows.Next 返回的是“还有没有下一行”，不是“查询是否成功”。当前结果集正常读完，或者从一开始就是空结果，都可能得到 false 与 nil 的组合。

下面按一个假设的排查场景展开：调用方希望读取一组编号，发现循环提前结束。示例是可集成的函数，不是已经执行过的事故复盘，也没有连接实际数据库产生测试结果。

我会先确认循环是不是已经正常结束

如果前面已经成功扫描了三行，第四次 Next 返回 false，Err 为 nil，通常意味着当前结果集正常结束。把这次 false 记为错误，会让正常请求进入告警，甚至触发没有意义的重试。

更可靠的观察点是：这是谁创建的 Rows、之前调用了几次 Next、成功扫描了几行、有没有其他函数提前关闭结果集。只有确认没有提前消费或关闭，才能把第一次 Next 就返回 false 理解为该结果集没有可读取的行。遇到多个结果集，还应通过 NextResultSet 判断后续集合，不能把当前集合结束等同于整个操作无后续结果。

第一次Next就结束时再检查行数

我会先排除一种特别容易漏掉的代码：为了判断是否有数据，先调用一次 Next，随后再进入同样调用 Next 的循环。前一次调用已经把游标移到了第一行；循环再推进一次，就可能跳过它。如果只有一行，循环看上去就完全没有执行。

不要为了记录日志而额外推进游标，也不要把同一个 Rows 交给几个协程共同消费。用成功 Scan 后累计的条数观察结果，比在循环外“探一下”更清楚。需要处理第一行时，就在同一个循环里完成。

确认确实是空结果之后，再检查查询条件：应用与手工查询是否连到同一个实例和数据库、模式是否一致、参数值与类型是否一致、事务可见性和账号权限是否一致，以及分页偏移是否越过末尾。读写分离环境还要考虑当前读取的副本。这里的检查应限定在授权的只读诊断范围，不需要修改全局数据库配置，也不要把完整敏感参数写入日志。

把查询、扫描、遍历和关闭错误分开

对我来说，一个返回 nil 的 Rows.Err 不能替代所有错误检查。QueryContext 的错误来自执行查询；Scan 可能因列数、NULL 或类型转换失败；Rows.Err 负责报告遍历期间的错误。Close 也有自己的返回值。扫描错误发生后，应当立即保留并返回它，而不是到循环外再等 Rows.Err“找回来”。

下面的辅助函数约定：查询返回一个结果集、一列可扫描为 int64 的非 NULL 编号；空结果合法；出错不返回部分数据。db 由调用方持有，本函数不关闭连接池。调用方负责使用受信任的固定查询文本，并通过参数占位传递用户值；不同驱动占位符写法不同，不能把用户输入拼接进 query。

package queryresult

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

// ReadIDs 接收借用的连接池；调用方只传入可信、有限的单列查询。
func ReadIDs(ctx context.Context, db *sql.DB, query string, args ...any) (ids []int64, err error) {
    rows, err := db.QueryContext(ctx, query, args...)
    if err != nil {
        return nil, fmt.Errorf("执行查询: %w", err)
    }
    // 关闭错误只在没有主要错误时返回，不覆盖扫描或遍历错误。
    defer func() {
        if closeErr := rows.Close(); err == nil && closeErr != nil {
            ids = nil
            err = fmt.Errorf("关闭结果集: %w", closeErr)
        }
    }()

    // 空结果按约定返回非 nil 的空切片，不制造“数据库故障”。
    ids = make([]int64, 0)
    for rows.Next() {
        var id int64
        // Scan 的转换错误必须在调用处处理，不能依赖 Rows.Err 收集。
        if scanErr := rows.Scan(&id); scanErr != nil {
            return nil, fmt.Errorf("扫描编号: %w", scanErr)
        }
        ids = append(ids, id)
    }
    if iterErr := rows.Err(); iterErr != nil {
        return nil, fmt.Errorf("遍历结果集: %w", iterErr)
    }
    // 本函数只接受一个结果集；额外结果集即便为空，也属于契约不符。
    if rows.NextResultSet() {
        return nil, fmt.Errorf("查询返回了额外结果集")
    }
    if setErr := rows.Err(); setErr != nil {
        return nil, fmt.Errorf("切换结果集: %w", setErr)
    }
    return ids, nil
}

这不是独立 main 程序。接入时需要由项目已有的驱动和连接池调用它，并在调用方规定超时。它没有声称某个数据库地址、表或数据已经存在。若业务需要多个结果集，应改用明确的外层 NextResultSet 循环，分别读取每个集合；本例选择拒绝额外结果集，避免默默丢弃后面的结果。

defer 的关闭逻辑不会覆盖已经返回的扫描或遍历错误。正常遍历结束时，Rows 可能已经自动关闭，重复 Close 仍是允许的。不要反过来推断“Err 为 nil 就从未有人调用 Close”：显式关闭本身并不会把 Err 改成一个关闭错误，提前关闭仍应从生命周期找原因。

我更在意哪些证据能防止误判

排查记录至少应区分查询是否建立成功、扫描是否完成、遍历是否报错，以及最终扫描数量。不要只记录一句“Next=false”。如果函数把空切片当作成功，调用方就应按空列表处理；如果业务必须恰好一条，那是另一个结果数量契约，应显式检查数量或使用合适的单行查询接口。

建议在项目自己的测试数据库中覆盖空结果、一行、多行、Scan 转换失败、取消上下文和额外结果集等场景。预期是：空结果成功返回空切片；正常行全部保留；扫描和遍历错误返回带来源的错误；额外结果集按本函数约定拒绝。这些是建议的预期，不是本文已经执行过的测试记录。取消与驱动行为存在边界差异，应以项目使用的驱动和实际调用时序为准。

对于明确正常结束的游标，不要重新执行查询来“修复 Next”。重试会产生新的读取时点，并不能恢复旧游标，也可能掩盖调用方提前消费的问题。

几个容易混淆的问题

为什么没有 sql.ErrNoRows？

ErrNoRows 常见于 QueryRow 的 Scan 在没有匹配行时返回。QueryContext 返回 Rows 后，空集合通过 Next 的 false 表达，不会因此自动让 Rows.Err 返回 ErrNoRows。两种接口面向的结果形态不同。

Next 返回 false，就能立即忽略所有结果了吗？

不能。先检查当前集合遍历错误；允许多结果集的调用还需检查 NextResultSet 及其错误。已扫描的数据如何保留也应由函数契约决定。本例遇错丢弃部分结果，是为了让调用方不把不完整列表误认为完整列表。

Err 为空但业务数据不对，接下来查什么？

先查消费次数、关闭位置和查询条件，再查同环境下的数据可见性。nil 只说明没有该接口报告的遍历错误，不证明 SQL 语义正确、查询条件符合业务预期，或数据本来就应该存在。

归根到底，先把“没有下一行”与“发生了错误”分开，再把数据数量交给业务契约判断。这样处理 false 与 nil，代码和日志都会更诚实。

官方资料

Rows、QueryRow 与 ErrNoRows 的接口说明：https://pkg.go.dev/database/sql#Rows.Next

官方查询教程：https://go.dev/doc/database/querying

标准库实现：https://go.dev/src/database/sql/sql.go