Go语言中高效处理数据库查询结果（database/sql包查询结果映射详解）

1. 准备工作：连接数据库

首先，确保你已安装对应数据库的驱动（如 MySQL 使用 github.com/go-sql-driver/mysql）。然后建立数据库连接：

package mainimport (    "database/sql"    "fmt"    "log"    _ "github.com/go-sql-driver/mysql" // 驱动注册)func main() {    db, err := sql.Open("mysql", "user:password@tcp(127.0.0.1:3306)/dbname")    if err != nil {        log.Fatal(err)    }    defer db.Close()    // 测试连接    if err := db.Ping(); err != nil {        log.Fatal(err)    }    fmt.Println("数据库连接成功！")}

2. 定义结构体：用于映射查询结果

假设我们有一张用户表 users，包含字段 id、name 和 email。我们可以定义一个结构体来接收查询结果：

type User struct {    ID    int    `json:"id"`    Name  string `json:"name"`    Email string `json:"email"`}

3. 单行查询：使用 QueryRow

当你知道查询只返回一行（如根据 ID 查用户），使用 QueryRow 最合适：

func getUserByID(db *sql.DB, id int) (*User, error) {    var user User    err := db.QueryRow("SELECT id, name, email FROM users WHERE id = ?", id).Scan(        &user.ID,        &user.Name,        &user.Email,    )    if err != nil {        if err == sql.ErrNoRows {            return nil, fmt.Errorf("用户不存在")        }        return nil, err    }    return &user, nil}

注意：Scan 方法的参数必须是指针，这样才能将数据库值写入结构体字段。

4. 多行查询：使用 Query + Next 循环

当需要获取多条记录时，使用 Query 并配合 Next() 遍历结果集：

func getAllUsers(db *sql.DB) ([]User, error) {    rows, err := db.Query("SELECT id, name, email FROM users")    if err != nil {        return nil, err    }    defer rows.Close()    var users []User    for rows.Next() {        var u User        err := rows.Scan(&u.ID, &u.Name, &u.Email)        if err != nil {            return nil, err        }        users = append(users, u)    }    // 检查遍历过程中是否有错误    if err = rows.Err(); err != nil {        return nil, err    }    return users, nil}

5. 注意事项与最佳实践

• 字段顺序必须匹配：Scan 中变量的顺序必须与 SELECT 语句中字段顺序一致。
• 及时关闭 rows：使用 defer rows.Close() 防止资源泄漏。
• 处理空值：如果数据库字段可能为 NULL，应使用 sql.NullString 等类型。
• 避免 SQL 注入：始终使用参数化查询（如 WHERE id = ?），不要拼接字符串。

6. 总结

通过本文，你已经掌握了在 Go语言 中使用 database/sql 包进行 查询结果映射 的基本方法。无论是单行还是多行查询，核心都在于正确使用 Scan 方法将数据库列值绑定到 Go 变量。虽然 database/sql 是底层库，但理解它有助于你更好地使用 ORM（如 GORM）或构建高性能数据层。

记住，良好的 Go数据库操作习惯包括：使用连接池、处理错误、防止注入等。希望这篇教程能帮助你在实际项目中更自信地处理数据库查询！

关键词回顾：Go语言、database/sql、查询结果映射、Go数据库操作