Go rows.Next 返回 false 怎么区分结束和查询出错

写 Go 的数据库查询时，最容易被忽略的一行就是 for rows.Next()。循环停下来，并不等于“数据库没有更多数据”：Next 返回 false 时，可能是正常到达结果集末尾，也可能是在准备下一行时遇到了驱动错误、网络错误或上下文取消。

判断方法很明确：循环内立即处理 rows.Scan 的错误；循环结束后再检查 rows.Err()。只有 rows.Err() == nil，才能把 Next() == false 当成正常读完。

Next 返回 false 为什么不能直接当成查询结束

官方 database/sql 文档对 Rows.Next 的定义同时包含两种情况：没有下一行，或者准备下一行时发生错误。因此下面这种写法会吞掉错误：

for rows.Next() {
    // 读取数据
}
return result, nil // 可能把半截结果当成完整结果

尤其是流式结果集已经读到一部分后，底层连接才发现超时或传输异常，循环会直接停止。此时已经追加到切片里的数据仍然存在，但它代表的是“读到错误前的部分”，不是完整查询结果。

标准写法：把 Scan 错误和迭代错误分开判断

可复用的最小结构如下。注意 rows.Err() 必须位于循环之后，因为它检查的是迭代过程；而 Scan 只负责把当前行的列值解码到目标变量。

ctx, cancel := context.WithTimeout(ctx, 3*time.Second)
defer cancel()

rows, err := db.QueryContext(ctx,
    "SELECT id, name FROM users WHERE enabled = ?", true)
if err != nil {
    return nil, fmt.Errorf("query users: %w", err)
}
defer rows.Close()

var users []User
for rows.Next() {
    var u User
    if err := rows.Scan(&u.ID, &u.Name); err != nil {
        return nil, fmt.Errorf("scan user: %w", err)
    }
    users = append(users, u)
}
if err := rows.Err(); err != nil {
    return nil, fmt.Errorf("iterate users: %w", err)
}
return users, nil

这段代码有三个独立检查点：查询刚开始失败时返回；某一行字段类型不匹配时返回；循环因迭代错误结束时返回。错误用 %w 包装后，调用方还能用 errors.Is 或 errors.As 做分类处理。

用一张表定位 false 到底意味着什么

如果使用 context.WithTimeout，超时可能在循环中途发生。不要只看已经读出的行数，也不要因为结果切片非空就返回成功；先判断 rows.Err()，再决定是重试、返回部分数据还是报错。默认的 defer rows.Close() 对常规单结果集足够，官方文档也说明当 Next 返回 false 且没有更多结果集时，结果集会自动关闭；需要区分 Close 错误或处理多结果集时，再显式调用并检查返回值。

常见问题

rows.Next 返回 false 且 rows.Err 为 nil，是不是查询失败？

不是。这表示结果集正常结束，可能是查询确实没有行，也可能是所有行已经读完。

Scan 出错后还要继续调用 rows.Err 吗？

如果 Scan 错误已经决定返回，通常不必为了改写同一个错误再调用；但要保证结果集会通过 defer Close 释放。若选择记录并继续处理，则循环结束后仍应检查 rows.Err。

为什么不能在循环里只判断 err 变量？

因为 Next 返回的是布尔值，不会把迭代错误直接作为循环条件返回。循环外的 rows.Err() 才是官方提供的错误入口。可参考 Go database/sql 文档 的 Rows 说明。