本文讲解 Go 语言中使用 database/sql 包时常见的类型误用问题：为何直接将 db.QueryRow(...) 赋值给 err 变量会报错，以及如何正确检查 sql.ErrNoRows 等查询错误。
本文讲解 go 语言中使用 `database/sql` 包时常见的类型误用问题：为何直接将 `db.queryrow(...)` 赋值给 `err` 变量会报错，以及如何正确检查 `sql.errnorows` 等查询错误。
在 Go 的 database/sql 标准库中，db.QueryRow() 方法*返回的是 `sql.Row类型指针，而非error**。这是一个非常典型的初学者误区：误以为调用QueryRow后立即能获得错误结果。实际上，QueryRow本身只负责准备并执行查询（返回单行结果的封装对象），真正的错误发生在**后续对结果进行扫描（Scan`）时**。
❌ 错误写法（编译失败）
err := db.QueryRow("SELECT id, name FROM accounts WHERE steamid = ?", steamid)
// 编译错误：cannot use *sql.Row as type error
switch {
case err == sql.ErrNoRows:
// ...
}此处 db.QueryRow(...) 返回 *sql.Row，而 err 声明为 error 类型，Go 类型系统严格拒绝隐式转换——*sql.Row 并未实现 error 接口（缺少 Error() string 方法），因此编译报错。
✅ 正确写法：Scan() 才是错误发生的入口
*sql.Row 提供 Scan(dest ...any) 方法，用于将数据库行数据解包到变量中；该方法才真正返回 error，包括：
- sql.ErrNoRows：查询无匹配记录；
- 其他 SQL 错误（如类型不匹配、空值扫描到非-nil 指针等）。
标准推荐模式如下：
var id int
var name string
err := db.QueryRow("SELECT id, name FROM accounts WHERE steamid = ?", steamid).Scan(&id, &name)
switch {
case err == sql.ErrNoRows:
log.Println("未找到对应账户")
// 处理“记录不存在”逻辑（如返回 404、初始化默认值等）
case err != nil:
log.Printf("数据库查询异常: %v", err)
// 处理其他错误（如连接中断、语法错误等）
default:
// 成功获取数据，执行业务逻辑
fmt.Printf("查得账户: ID=%d, Name=%s\n", id, name)
}⚠️ 关键注意事项
Scan 必须被调用：即使你只关心是否存在记录（不读取字段），也需至少传入一个占位变量（如 var dummy struct{} 或 var _ int），否则不会触发错误检查。更清晰的做法是扫描一个 nil 指针（但需确保列数匹配）或使用 if err := row.Scan(&x); err != nil { ... }。
不要忽略 Scan 错误：即使 QueryRow 成功，Scan 仍可能失败（例如 SELECT COUNT(*) 却尝试扫描两个变量）。务必始终检查 Scan 的返回值。
sql.ErrNoRows 是哨兵错误，可安全比较：它是预定义的导出变量（var ErrNoRows = errors.New("sql: no rows in result set")），因此可用 == 直接判断，无需 errors.Is()（尽管后者在 Go 1.13+ 中也兼容）。
? 进阶提示：更简洁的写法（Go 1.21+）
若仅需判断存在性且无需字段值，可结合 Row.Scan 与 _ 空标识符：
err := db.QueryRow("SELECT 1 FROM accounts WHERE steamid = ?", steamid).Scan(&struct{}{})
if err == sql.ErrNoRows {
// 不存在
} else if err != nil {
// 其他错误
} else {
// 存在
}但注意：SELECT 1 需确保表结构支持，且语义上不如明确字段清晰。生产环境建议始终扫描实际业务字段以保证健壮性。
掌握 QueryRow 与 Scan 的职责分离，是写出健壮 Go 数据库代码的第一步。记住核心原则：QueryRow 不报错，Scan 才定乾坤。
