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()，否则连接会一直被占用，直到超时释放。
本地项目发布到GitHub的完整工作流助手。自动执行：安全检查（.gitignore、排除敏感.env/凭据文件）、补齐开源文件（LICENSE、.gitignore）、git init/commit/branch、创建远程仓库、首次推送、可选打tag。支持git filter-repo历史敏感信息重写、force push、tag管理。Windows下走Credential Manager自动认证。触发词："发布到GitHub"、"上传到github"、"
- 用
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 - 结构体字段要导出（首字母大写），且用
dbtag 显式映射，比如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 会失败。这类细节不写日志、不跑真实数据根本发现不了。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
