用 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())时才会尝试连。
所以生产环境务必在初始化后加健康检查:
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 into type *string。