要判断是 sql.errnorows 错误,应直接比较 err == sql.errnorows 或使用 errors.is;1. 在 queryrow 调用 scan 时返回 sql.errnorows 表示未找到记录;2. 使用 query 或 querycontext 时不会触发 sql.errnorows,需手动检查结果集是否为空;3. 建议封装数据库操作统一处理该错误,并避免将其视为严重问题。

在 Go 语言中处理数据库操作错误时,很多开发者容易忽略一些特殊情况,比如
sql.ErrNoRows。这个错误表示查询没有返回任何行,虽然它是一个“正常”的情况(比如根据 ID 查询用户不存在),但如果不做区分处理,很容易导致程序误判为异常。

下面是一些实用的建议,帮助你更好地识别和处理这类特殊错误。

如何判断是 sql.ErrNoRows 错误
在使用
*sql.Row的
Scan方法时,如果查询没有返回任何行,会返回
sql.ErrNoRows。这是标准库定义的一个特定错误值,可以通过直接比较来识别:
立即学习“go语言免费学习笔记(深入)”;
var user User
err := db.QueryRow("SELECT name FROM users WHERE id = ?", id).Scan(&user)
if err != nil {
if err == sql.ErrNoRows {
// 处理没有找到记录的情况
} else {
// 处理其他数据库错误
}
}需要注意的是:只有在使用
QueryRow并调用
Scan时才会返回
sql.ErrNoRows。如果是用
Query或者执行更新语句,不会触发这个错误。

使用 Query 和 QueryContext 时如何处理空结果
当你使用
Query或
QueryContext获取多条记录时,即使没有结果也不会返回
sql.ErrNoRows。这时候你需要通过检查是否有数据来判断是否为空:
rows, err := db.Query("SELECT name FROM users WHERE role = ?", role)
if err != nil {
// 处理数据库错误
}
defer rows.Close()
var names []string
for rows.Next() {
var name string
if err := rows.Scan(&name); err != nil {
// 处理扫描错误
}
names = append(names, name)
}
// 检查是否没有任何结果
if len(names) == 0 {
// 可以自定义一个 not found 错误或直接处理逻辑
}这种情况下,没有数据只是业务逻辑上的“空”,不是错误状态,所以不会抛出
sql.ErrNoRows。
常见误区与建议
不要把所有数据库错误都当作严重问题
例如sql.ErrNoRows
就是一个预期中的情况,应该按业务逻辑处理,而不是直接打印日志或中断流程。避免重复判断错误类型
如果你封装了数据库操作函数,可以统一处理sql.ErrNoRows
,并返回更清晰的业务错误码或布尔标志。-
使用 errors.Is 更安全地判断错误类型
虽然可以直接用==
判断sql.ErrNoRows
,但在嵌套错误的情况下,推荐使用errors.Is
:if errors.Is(err, sql.ErrNoRows) { // 处理未找到记录的情况 } 适当封装查询逻辑
对于常用查询操作,可以封装成函数,并返回是否找到结果的布尔值,这样上层逻辑更容易处理。
基本上就这些。Go 中的数据库错误处理看似简单,但稍不注意就会漏掉像
sql.ErrNoRows这样的细节。只要在关键位置做好判断和封装,就能写出更健壮的代码。










