Go 中 sql.QueryRow 错误处理方法

本文深入剖析 Go 语言中 sql.QueryRow 的典型误用陷阱——尤其警示开发者切勿将 *sql.Row 直接赋值给 error 变量（这会导致编译失败），并清晰揭示其设计本质：*sql.Row 仅是惰性查询句柄，真正的执行与错误发生在调用 Scan() 时；文章通过正反对比代码、常见错误场景（如 sql.ErrNoRows 的正确处理）、关键注意事项及实用技巧，手把手教你写出健壮、符合 Go 惯例的数据库查询逻辑，助你避开隐蔽坑点，提升工程可靠性。

本文详解 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 习惯的数据库操作代码的关键。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Go 中 sql.QueryRow 错误处理方法》文章吧，也可关注golang学习网公众号了解相关技术文章。