Go语言如何操作MySQL数据库_Golang数据库实战项目_技术教程

Go操作MySQL需理清连接、查询、事务、错误处理四主线：sql.Open仅初始化连接池，须设MaxOpenConns/MaxIdleConns等参数并Ping检测；Query用于多行、QueryRow用于单行；事务需显式Commit/Rollback且用tx方法；Scan要字段数匹配、处理NULL、注意类型映射。

Go 语言操作 MySQL 数据库，核心是用 database/sql 包配合 mysql 驱动（如 github.com/go-sql-driver/mysql），不是“封装 ORM 就完事”，而是先理清连接、查询、事务、错误处理这四条主线。

如何正确打开并复用 MySQL 连接池

直接调用 sql.Open 不会真正连数据库，只是初始化一个连接池；真连接发生在第一次 Query 或 Exec 时。必须显式设置连接池参数，否则默认 MaxOpenConns=0（无上限）、MaxIdleConns=2（极易在并发下打满 MySQL）。

db, err := sql.Open("mysql", "user:pass@tcp(127.0.0.1:3306)/test?parseTime=true&loc=Local")
if err != nil {
    log.Fatal(err)
}
db.SetMaxOpenConns(20)
db.SetMaxIdleConns(10)
db.SetConnMaxLifetime(60 * time.Second)

parseTime=true：让驱动把 DATETIME 解析为 time.Time，否则返回 []byte
loc=Local：避免时区错乱，不加可能导致时间字段比实际快/慢 8 小时
别漏掉 db.Ping() 主动测连通性，尤其在服务启动时

Query 和 QueryRow 的区别与选型场景

Query 返回 *sql.Rows，用于多行结果（哪怕只查 1 行）；QueryRow 返回 *sql.Row，专为「最多一行」设计，自动调用 Scan 后关闭游标。用错会导致连接泄漏或 panic。

查单条记录（如 SELECT id,name FROM user WHERE id=123）→ 用 QueryRow
查列表（如 SELECT * FROM order WHERE status='paid'）→ 用 Query，且必须 defer rows.Close()
QueryRow.Scan() 失败时，错误可能是 sql.ErrNoRows，需单独判断，不能忽略

var name string
err := db.QueryRow("SELECT name FROM user WHERE id = ?", 123).Scan(&name)
if err == sql.ErrNoRows {
    // 记录不存在
} else if err != nil {
    // 其他错误
}

事务中如何安全地 Commit / Rollback

Go 的事务不是自动回滚的。一旦 tx, err := db.Begin() 成功，就必须显式调用 tx.Commit() 或 tx.Rollback()，否则连接会一直被占用，直到超时释放。

用 defer tx.Rollback() 开头，再在成功路径末尾 tx.Commit() 并 return，确保 Rollback 只执行一次
不要在事务里调用 db.Query，必须用 tx.Query / tx.Exec，否则脱离事务上下文
事务内发生 panic？Go 不会自动 rollback，需用 recover 捕获并手动 rollback（生产环境建议用中间件统一处理）

tx, err := db.Begin()
if err != nil {
    return err
}
defer func() {
    if p := recover(); p != nil {
        tx.Rollback()
        panic(p)
    }
}()
_, err = tx.Exec("INSERT INTO log(msg) VALUES(?)", "start")
if err != nil {
    tx.Rollback()
    return err
}
err = tx.Commit()
if err != nil {
    return err
}

为什么 Scan 时经常报 “sql: expected 2 destination arguments in Scan”

这个错误本质是 Scan 参数个数和 SELECT 字段数不匹配，常见于：字段别名写错、SELECT * 但结构体字段少、NULL 值没用 sql.NullString 等类型接收。

永远用具体字段名，不用 SELECT *，避免表结构变更后 Scan 崩溃
字段可能为 NULL？对应变量必须用 sql.NullString / sql.NullInt64 等
，不能直接用 string 或 int
结构体字段要导出（首字母大写），且用 db tag 显式映射，比如 Name string `db:"user_name"`

最稳妥的方式是按字段顺序逐个 Scan，而不是依赖结构体反射：

rows, err := db.Query("SELECT id, name, created_at FROM user WHERE id > ?", 100)
if err != nil {
    return err
}
defer rows.Close()
for rows.Next() {
    var id int64
    var name string
    var createdAt time.Time
    if err := rows.Scan(&id, &name, &createdAt); err != nil {
        return err
    }
    // 处理数据
}

MySQL 类型和 Go 类型的映射关系容易被忽略——比如 MySQL 的 TINYINT(1) 默认被当 bool，但如果你用的是 tinyint(4) 存状态码，就一定得用 int8 接收，否则 Scan 会失败。这类细节不写日志、不跑真实数据根本发现不了。