用 database/sql + github.com/go-sql-driver/mysql 驱动连接 MySQL，需下划线导入触发 init() 注册驱动；sql.Open 仅初始化连接池，db.Ping() 才真实建连；parseTime=true 解析 time.Time；NULL 值须用 sql.NullString 等类型接收；事务中 defer tx.Rollback() 必须配合提交状态判断，否则误回滚。
用 database/sql + mysql 驱动就能连，但别直接写 github.com/go-sql-driver/mysql
Go 官方推荐用 database/sql 接口抽象，驱动只是实现。真正要导入的是第三方 MySQL 驱动，最常用的是 github.com/go-sql-driver/mysql，但它本身不提供高级 ORM 功能，只负责底层通信。
常见错误是以为 import 了驱动就自动注册——其实必须显式调用或触发 init()。正确写法是：
import (
"database/sql"
_ "github.com/go-sql-driver/mysql" // 注意下划线，只为执行 init()
)
没这行，sql.Open("mysql", ...) 会报错：sql: unknown driver "mysql"。
sql.Open 不是真的连数据库，只是初始化连接池
sql.Open 返回 *sql.DB 对象，它不校验数据库是否可达，也不建立实际 TCP 连接。真正第一次执行查询（比如 db.Ping() 或 db.QueryRow()）时才会尝试连。
立即学习“go语言免费学习笔记（深入）”；
所以生产环境务必在初始化后加健康检查：
db, err := sql.Open("mysql", "user:pass@tcp(127.0.0.1:3306)/test?parseTime=true")
if err != nil {
log.Fatal(err)
}
if err := db.Ping(); err != nil { // 这里才真正拨号
log.Fatal("failed to connect to MySQL:", err)
}
-
parseTime=true是关键参数，否则time.Time字段会解析成字符串 - 连接串里不要漏
tcp(...)，写成user:pass@/path/to/socket是 Unix socket 模式，本地调试可用，但多数容器部署走 TCP - 密码含特殊字符（如
@、/）必须 URL 编码，否则解析失败
查询结果怎么安全取值？别直接用 Scan 绑定裸指针
MySQL 返回的 NULL 值在 Go 里对应 sql.NullXXX 类型，比如 sql.NullString。如果字段可能为 NULL，又用 string 变量接收，运行时 panic：sql: Scan error on column index 0: unsupported Scan, storing driver.Value type 。
正确做法分两种场景：
- 明确非空字段：用普通类型 + 地址符，如
var name string; row.Scan(&name) - 可能为空字段：必须用
sql.NullString等包装类型，再判断.Valid
示例：
var name sql.NullString
var age sql.NullInt64
err := row.Scan(&name, &age)
if err != nil {
return err
}
if name.Valid {
fmt.Println("name:", name.String)
}
if age.Valid {
fmt.Println("age:", age.Int64)
}
事务手动控制时，记得 Rollback 要用 defer 但不能无条件执行
很多人写事务这样：
tx, _ := db.Begin() defer tx.Rollback() // ❌ 错！成功提交后还 rollback
这会导致事务永远回滚。正确模式是：
tx, err := db.Begin()
if err != nil {
return err
}
defer func() {
if r := recover(); r != nil {
tx.Rollback()
}
}()
if _, err := tx.Exec("INSERT ..."); err != nil {
tx.Rollback()
return err
}
return tx.Commit()
更稳妥的做法是用命名返回值或显式 flag 标记是否已提交，避免 defer 误操作。另外，tx.QueryRow 等方法失败不会自动 rollback，必须自己处理。
连接池设置（SetMaxOpenConns、SetMaxIdleConns）容易被忽略，高并发下不调优会导致连接耗尽或复用率低，但那是进阶问题，先确保单次查询通再优化。
