QueryRow() 查询无结果时返回 sql.ErrNoRows 而非 nil,须用 errors.Is(err, sql.ErrNoRows) 判断并区分处理;其他错误如连接异常、类型不匹配等需单独应对。

在 Go 中使用 database/sql 包查询单条记录时,若查不到数据,QueryRow() 不会返回 nil 错误,而是返回一个特殊的错误值 sql.ErrNoRows。正确识别并处理它,是避免程序误判或 panic 的关键。
为什么不能用 err == nil 判断查询成功
QueryRow().Scan() 的典型写法是:
err := row.Scan(&id, &name)
如果数据库中没有匹配行,row.Scan() 会返回 sql.ErrNoRows,而不是 nil。若你只检查 err != nil 就 panic 或直接返回,可能掩盖真实错误;但若忽略 err,又会导致变量未赋值、后续逻辑出错。
立即学习“go语言免费学习笔记(深入)”;
正确判断 sql.ErrNoRows 的方式
使用 errors.Is()(Go 1.13+)进行语义比较,安全且推荐:
动态WEB网站中的PHP和MySQL详细反映实际程序的需求,仔细地探讨外部数据的验证(例如信用卡卡号的格式)、用户登录以及如何使用模板建立网页的标准外观。动态WEB网站中的PHP和MySQL的内容不仅仅是这些。书中还提到如何串联JavaScript与PHP让用户操作时更快、更方便。还有正确处理用户输入错误的方法,让网站看起来更专业。另外还引入大量来自PEAR外挂函数库的强大功能,对常用的、强大的包
- if errors.Is(err, sql.ErrNoRows) { /* 无数据 */ }
- 不要用
err == sql.ErrNoRows—— 某些驱动可能包装该错误,导致比较失败 - 也不要仅靠
err != nil就认为是严重错误,需先区分是否为ErrNoRows
常见使用模式示例
查询用户并处理「不存在」场景:
var id int
var name string
err := db.QueryRow("SELECT id, name FROM users WHERE id = ?", 123).Scan(&id, &name)
if err != nil {
if errors.Is(err, sql.ErrNoRows) {
log.Println("用户不存在")
return nil, fmt.Errorf("user not found")
} else {
log.Printf("数据库查询失败: %v", err)
return nil, err
}
}fmt.Printf("找到用户: %d, %s", id, name)
注意其他潜在错误类型
QueryRow().Scan() 可能返回的不只是 sql.ErrNoRows:
-
连接错误:如
driver.ErrBadConn,可能需要重试 -
类型不匹配:如把字符串 Scan 到 int,报
"sql: Scan error on column index 0" -
空值(NULL)未处理:字段允许 NULL 时,应使用
sql.NullString等类型接收
因此,ErrNoRows 是业务逻辑中的正常分支,而其他错误才属于异常情况,需分别应对。









