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语言免费学习笔记（深入）”；
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
正确判断 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 是业务逻辑中的正常分支，而其他错误才属于异常情况，需分别应对。
