如何在 Go 应用中正确管理数据库连接（初始化、复用与健康检查）-Golang-PHP中文网

如何在 Go 应用中正确管理数据库连接（初始化、复用与健康检查）

在 Go 中应全局复用 *sql.DB 实例而非每次操作都调用 sql.Open()；它本身是并发安全的连接池，启动时初始化并配合 Ping() 验证连通性即可，无需手动频繁开闭。

在 go 中应全局复用 `*sql.db` 实例而非每次操作都调用 `sql.open()`；它本身是并发安全的连接池，启动时初始化并配合 `ping()` 验证连通性即可，无需手动频繁开闭。

Go 的 database/sql 包设计精巧，*sql.DB 并非单个数据库连接，而是一个线程安全的连接池管理器。它会自动复用空闲连接、创建新连接、回收超时连接，并支持高并发场景下的高效访问。因此，反复在每个函数（如 CreateUser）中调用 sql.Open() 是严重反模式：不仅性能低下（TCP 建连 + 认证开销），还会快速耗尽数据库连接数，甚至引发“too many connections”错误。

✅ 正确做法：应用启动时一次性初始化 *sql.DB，并在整个生命周期内复用。推荐使用包级变量 + init() 函数实现简洁可靠的初始化：

package db

import (
    "database/sql"
    "log"
    _ "github.com/lib/pq" // PostgreSQL driver
)

var DB *sql.DB

func init() {
    var err error
    DB, err = sql.Open("postgres", "user=postgres password=password dbname=api_dev sslmode=disable")
    if err != nil {
        log.Fatal("Failed to parse database config:", err)
    }

    // 可选：设置连接池参数（强烈建议）
    DB.SetMaxOpenConns(25)   // 最大打开连接数
    DB.SetMaxIdleConns(25)   // 最大空闲连接数
    DB.SetConnMaxLifetime(5 * time.Minute) // 连接最大存活时间

    // 关键：验证实际连通性（sql.Open 不建立物理连接！）
    if err = DB.Ping(); err != nil {
        log.Fatal("Failed to connect to database:", err)
    }
}

⚠️ 注意事项：

sql.Open() 仅校验 DSN 格式，不建立真实连接；务必调用 DB.Ping() 主动探测数据库可达性；
*sql.DB 是并发安全的，可放心注入到 handler、service 或 repository 层（例如通过依赖注入或上下文传递），无需额外锁；
避免全局 defer db.Close() —— *sql.DB 应长期存活，通常只在应用优雅退出时关闭（如监听 os.Interrupt 后调用 DB.Close()）；
若使用模块化架构（如分层 service），更推荐将 *sql.DB 作为依赖显式传入，而非依赖全局变量，便于单元测试和解耦。