在 Go 中调用 db.QueryRow() 返回的是 *sql.Row 类型，而非 error；必须显式调用 .Scan() 方法才会触发查询执行并返回错误（如 sql.ErrNoRows），直接将 QueryRow 赋值给 err 变量会导致类型不匹配编译错误。
在 go 中调用 `db.queryrow()` 返回的是 `*sql.row` 类型，而非 `error`；必须显式调用 `.scan()` 方法才会触发查询执行并返回错误（如 `sql.errnorows`），直接将 `queryrow` 赋值给 `err` 变量会导致类型不匹配编译错误。
db.QueryRow() 是一个惰性操作——它仅构建查询准备结构，并不真正执行 SQL 或访问数据库。真正的执行和错误产生发生在后续的 .Scan() 调用时。因此，以下写法是错误且无法编译的：
// ❌ 错误：QueryRow() 返回 *sql.Row，不能直接赋给 err（error 类型）
err := db.QueryRow("SELECT id, name FROM accounts WHERE steamid = ?", steamid)
// 编译错误：cannot use *sql.Row as type error✅ 正确做法是：先获取 *sql.Row，再调用 .Scan() 并检查其返回的 error：
var id int
var name string
row := db.QueryRow("SELECT id, name FROM accounts WHERE steamid = ?", steamid)
err := row.Scan(&id, &name) // ✅ 执行查询，此时才可能返回 sql.ErrNoRows 或其他 error
switch {
case err == sql.ErrNoRows:
log.Println("未找到匹配的账号")
case err != nil:
log.Printf("数据库查询出错：%v", err)
return err
default:
// ✅ 查询成功，数据已写入 id 和 name
fmt.Printf("查到账号：ID=%d, Name=%s\n", id, name)
}⚠️ 注意事项：
- sql.ErrNoRows 仅在 .Scan() 未读取到任何行时返回，且前提是 SQL 语句语法正确、连接正常。网络超时、权限不足等错误会返回其他 error。
- 若只需判断是否存在记录（无需读取字段），可使用 sql.NullInt64 等占位扫描，或改用 db.Query() + rows.Next() 模式，但 QueryRow().Scan() 仍是单行查询最简洁安全的方式。
- 切勿忽略 Scan() 的错误：即使 QueryRow() 无 panic，遗漏 Scan 错误检查将导致静默失败或 panic（如扫描到 nil 指针）。
? 小技巧：可封装为工具函数提升可读性：
func FindAccountBySteamID(db *sql.DB, steamid string) (Account, error) {
var acc Account
err := db.QueryRow(
"SELECT id, name, created_at FROM accounts WHERE steamid = ?",
steamid,
).Scan(&acc.ID, &acc.Name, &acc.CreatedAt)
if err != nil {
if errors.Is(err, sql.ErrNoRows) {
return Account{}, fmt.Errorf("account not found: %w", err)
}
return Account{}, fmt.Errorf("query failed: %w", err)
}
return acc, nil
}总结：Go 的 database/sql 包遵循“延迟执行 + 显式错误”设计哲学。牢记 QueryRow() ≠ 执行，Scan() 才是关键分水岭——所有与结果集相关的错误（包括 sql.ErrNoRows）都源于 Scan，而非 QueryRow。掌握这一机制，是写出健壮数据库交互代码的基础。
