golang怎么使用mysql-Golang-PHP中文网

sql.open 不建立连接，必须紧接 db.ping() 验证；dsn 需 url.queryescape 密码、含 tcp() 和 parsetime=true+loc=local；query 后必调 rows.next() 和 rows.close()；null 值须用 sql.nullstring 等类型；超时需用 context 控制。

golang怎么使用mysql

sql.Open 之后必须立刻 db.Ping()

很多 panic 实际发生在第一次查询时，不是 sql.Open 那一刻。它只解析 DSN、注册驱动、配置连接池，不建 TCP 连接。你写 db, err := sql.Open("mysql", dsn) 即使 MySQL 完全宕机、密码错、端口填成 3307，err 也几乎总是 nil。

真正暴露问题的只有 db.Ping() —— 它会强制获取一个连接并握手。上线前漏掉这步，服务启动后第一个请求就崩。

必须紧接在 sql.Open 后调用：if err := db.Ping(); err != nil { log.Fatal(err) }
别把 db.Ping() 放在 HTTP handler 里做“懒校验”，它该是初始化阶段的硬性检查
如果用容器部署，Ping() 失败常伴随 dial tcp: lookup mysql: no such host（DNS 未配置）或 connection refused（端口没暴露/没映射）

DSN 字符串里 parseTime=true 和 loc=Local 必须成对出现

漏掉 parseTime=true，查 DATETIME 字段时 Scan() 会直接 panic：unsupported Scan, storing driver.Value type []uint8 into type *time.Time。这不是类型写错，是驱动根本没启用时间解析。

loc=Local 不是可选参数：MySQL 返回的时间戳默认按服务器时区解释，Go time.Time 默认 UTC。不加 loc，上海服务器存的 2026-04-27 14:00:00 在 Go 里可能变成 2026-04-27 06:00:00 +0000 UTC。

Alibabacloud Sdk Client Initialization For Golang

初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。

下载

开发环境用 loc=Local 最省事；生产建议统一用 loc=UTC，应用层再转本地时区
密码含 @ 或 / 时，必须先 url.QueryEscape()，否则 DSN 解析失败
别写 mysql:// 或漏掉 tcp() —— 正确格式只能是 user:pass@tcp(127.0.0.1:3306)/dbname?parseTime=true&loc=Local

Query 多行时 rows.Next() 和 rows.Close() 缺一不可

db.Query() 返回 *sql.Rows，它背后绑着一个连接。跳过 rows.Next() 直接 Scan() 会 panic：sql: Scan called without calling Next。而漏掉 rows.Close()，连接永远不归还池子，SetMaxOpenConns 很快被耗尽，后续所有查询卡死或报 too many connections。

标准写法必须带 defer rows.Close()，且放在 if err != nil 检查之后
循环结束后要显式检查 rows.Err()，否则磁盘 I/O 错误、网络中断会被静默吞掉
即使 rows.Next() 一次都没进（结果为空），rows.Close() 仍需调用

NULL 值必须用 sql.NullString 而不是 *string

MySQL 字段允许为 NULL，但 Go 原生类型如 string、int64 无法表示 “有值” 和 “数据库 NULL” 的区别。直接 Scan(&name) 到 string，遇到 NULL 就 panic：sql: Scan error on column index X: unsupported Scan, storing driver.Value type <nil> into type *string</nil>。

别用 *string 替代 —— database/sql 不支持 Scan 到未初始化指针，且业务层判断 name == nil 语义模糊（是没查到？还是字段真为 NULL？）。