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)

注意其他潜在错误类型

QueryRow().Scan() 可能返回的不只是 sql.ErrNoRows：

• 连接错误：如 driver.ErrBadConn，可能需要重试
• 类型不匹配：如把字符串 Scan 到 int，报 "sql: Scan error on column index 0"
• 空值（NULL）未处理：字段允许 NULL 时，应使用 sql.NullString 等类型接收

因此，ErrNoRows 是业务逻辑中的正常分支，而其他错误才属于异常情况，需分别应对。