如何使用Golang处理数据库操作错误_使用sql.ErrNoRows判断结果

P粉602998670 2025-12-20 00:00:00 次阅读

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，又会导致变量未赋值、后续逻辑出错。

正确判断 sql.ErrNoRows 的方式

使用 errors.Is()（Go 1.13+）进行语义比较，安全且推荐：

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)