Golang数据库操作实战教程

本文深入剖析了使用 Go 语言通过 database/sql 操作 MySQL 数据库时最易踩坑的增删改查实战要点：从驱动注册、DSN 配置（尤其 parseTime=true）、连接验证（db.Ping）到单行查询（QueryRow + 错误分层处理）、执行结果解析（LastInsertId/RowsAffected）、连接池调优（MaxOpenConns/MaxIdleConns/ConnMaxLifetime）以及资源释放（*sql.Rows 必须 Close），直击生产环境中高频故障根源，帮你避开静默失败、连接泄漏、类型 panic 和高并发卡死等致命陷阱，真正写出健壮、可维护、高性能的数据库交互代码。

用 database/sql 连 MySQL 时连不上，常见是驱动没注册

Go 的 database/sql 是接口层，不自带驱动。你写 sql.Open("mysql", dsn) 但没导入对应驱动包，就会报错 sql: unknown driver "mysql"。

实操建议：

• 必须显式导入驱动，比如 import _ "github.com/go-sql-driver/mysql"（下划线表示只执行 init）
• DSN 格式要对：用户名:密码@tcp(127.0.0.1:3306)/dbname?parseTime=true&loc=Local
• 别漏掉 parseTime=true，否则 time.Time 字段会扫成字符串
• sql.Open 不真连数据库，得调 db.Ping() 才能确认连接通不通

QueryRow 查单行时忘记检查 Err，程序 panic 或静默失败

QueryRow 返回的 *sql.Row 不会在调用时立即报错，而是在你调 .Scan() 时才暴露问题。如果查不到数据，Scan() 会返回 sql.ErrNoRows；如果字段类型不匹配，会 panic。

实操建议：

• 永远检查 Scan() 的返回值：err := row.Scan(&id, &name)
• 遇到 sql.ErrNoRows 要单独处理，不是所有“查无结果”都该当错误抛出
• 字段顺序、数量、类型必须和 SELECT 完全一致，比如数据库是 TIMESTAMP，Go 里就得用 *time.Time 或 time.Time 接收
• 别用 QueryRow(...).Scan(...) 连写，中间没机会判断 row.Err()

增删改用 Exec 后忽略 Result.LastInsertId 和 RowsAffected

插入后想拿自增 ID，或更新后想确认影响了几行，光调 db.Exec() 不够——它返回 sql.Result，你要主动取。

实操建议：

• 插入后要 ID：用 res.LastInsertId()（仅 MySQL/SQLite 支持，PostgreSQL 不支持）
• 想确认是否真改了数据：用 res.RowsAffected()，返回 int64，注意它可能为 0（比如 WHERE 条件没命中）
• 别把 Exec 当黑盒，尤其做幂等操作时，RowsAffected == 0 往往比 err 更关键
• 事务中执行多个 Exec，每个都要检查自己的 Result，不能只看最后一个

不设连接池参数，高并发下卡死或连爆

默认的 db.SetMaxOpenConns(0) 表示不限制最大连接数，db.SetMaxIdleConns(2) 却只留 2 个空闲连接。压测时容易出现大量新建连接、连接等待、甚至被数据库拒绝。

实操建议：

• 上线前必须设： db.SetMaxOpenConns(20)、db.SetMaxIdleConns(10)、db.SetConnMaxLifetime(60 * time.Second)
• MaxOpenConns 建议设为数据库连接数上限的 70% 左右，避免 DB 端过载
• ConnMaxLifetime 防止连接复用太久导致网络中断后还挂着，MySQL 默认 wait_timeout 是 8 小时，但中间网络设备可能更早断连
• 用完 *sql.Rows 必须 rows.Close()，否则连接不会归还给池子

最常被跳过的其实是 rows.Close() 和 db.Ping() ——它们不报错，但一到并发或长时间运行就露馅。

今天关于《Golang数据库操作实战教程》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！