本文详解 go 语言中使用 sql.queryrow 时常见的类型误用错误，重点说明为何直接将 *sql.row 赋值给 error 变量会导致编译失败，并演示如何通过 scan() 方法正确获取并判断数据库查询结果与错误（如 sql.errnorows）。
本文详解 go 语言中使用 sql.queryrow 时常见的类型误用错误，重点说明为何直接将 *sql.row 赋值给 error 变量会导致编译失败，并演示如何通过 scan() 方法正确获取并判断数据库查询结果与错误（如 sql.errnorows）。
在 Go 的 database/sql 包中，db.QueryRow(...) 返回的是一个 *sql.Row 类型的指针，它本身不是错误，也不实现 error 接口。因此，像下面这样的写法是非法的：
err := db.QueryRow("SELECT id FROM accounts WHERE steamid = ?", steamid) // ❌ 编译错误！
// *sql.Row 不能赋值给 error 类型该语句会触发编译器报错：
cannot use db.QueryRow(...) (type *sql.Row) as type error in assignment
这是因为 *sql.Row 没有 Error() string 方法，不满足 error 接口定义。
✅ 正确做法是：*先获取 `sql.Row，再调用其Scan()方法**——而Scan()` 才真正执行查询并返回错误：
var id int
var username, email string
row := db.QueryRow("SELECT id, username, email FROM accounts WHERE steamid = ?", steamid)
err := row.Scan(&id, &username, &email) // ✅ Scan() 返回 error
switch {
case err == sql.ErrNoRows:
log.Println("未找到匹配的账号")
case err != nil:
log.Printf("查询出错: %v", err)
default:
// 查询成功，数据已写入变量
fmt.Printf("查到用户: %s (%d)\n", username, id)
}⚠️ 注意事项：
- Scan() 必须传入对应列数量和类型的地址（&var），否则会 panic；
- 若 SQL 查询字段数与 Scan 参数不匹配，将返回 sql.ErrNoRows 或其他扫描错误（如类型不兼容）；
- 即使查询语句语法正确，若无匹配行，Scan() 仍会返回 sql.ErrNoRows —— 这是预期行为，不是异常；
- 不要忽略 Scan() 的返回值：即使 QueryRow 成功，Scan 失败也意味着数据未正确读取。
? 小技巧：可链式调用简化代码（但可读性略降）：
err := db.QueryRow("SELECT id FROM accounts WHERE steamid = ?", steamid).Scan(&id)总结：*sql.Row 是惰性执行的查询句柄，真正的错误发生在 Scan() 阶段。理解这一设计逻辑，是写出健壮、符合 Go 习惯的数据库操作代码的关键。
