如何正确初始化和复用 Go 的 sql.DB 连接池

先说几个核心判断：在Go里面，sql.Open这件事，做一次就够了。而且，它返回的那个*sql.DB，本质上是一个全局的、线程安全的、自带连接池的管理器。你不需要，也不应该频繁地去重建它。

很多刚开始接触Go的同学容易在这个地方踩坑——拿到一个sql.Open就以为它跟建立一次数据库连接是一回事。其实不是。这里面的设计哲学很明确：Go的database/sql包是面向连接池的，而不是面向单次连接的。当你调用sql.Open的时候，它并没有真的去连数据库，它只是初始化了一个逻辑上的数据库句柄，这个句柄内部维护着一个可复用、并发安全的空闲连接池。真正触发物理连接的，是你第一次执行查询（比如Query、Exec），或者显式调用db.Ping()。

那正确的打开方式是什么？

最佳实践是在程序启动阶段——比如init()函数或者main()的开头——调用一次sql.Open，然后立刻用Ping()验证一下连通性。这样既能保证连接池初始化成功，又不会让程序在后续运行时因为一个不可用的数据库句柄而崩溃。

package db

import (
    "database/sql"
    "log"
    _ "github.com/lib/pq" // PostgreSQL 驱动示例
)

var DB *sql.DB

func init() {
    var err error
    DB, err = sql.Open("postgres", "user=app dbname=mydb sslmode=disable")
    if err != nil {
        log.Fatal("failed to open database:", err)
    }

    // 主动验证连接可用性
    if err = DB.Ping(); err != nil {
        log.Fatal("failed to ping database:", err)
    }

    // 可选：优化连接池参数（根据负载调整）
    DB.SetMaxOpenConns(25)
    DB.SetMaxIdleConns(10)
    DB.SetConnMaxLifetime(5 * time.Minute)
}

这里有几个值得注意的地方：

• 不要在每一个函数或者HTTP handler里调用sql.Open。 那样做会产生大量冗余的*sql.DB实例，资源浪费不说，连接池也无法共享，结果就是连接数暴增，或者文件描述符被耗尽。这在生产环境里是致命的。
• 不需要手动调用Close()，除非程序要退出了。 *sql.DB的生命周期跟应用是一致的。如果你在程序结束时需要优雅地关闭所有空闲连接，那在main结束前调用一次Close()就够了。但平常是不需要动它的。
• 全局变量不是唯一的选择，但实例必须是全局唯一的。 如果你的项目模块化程度比较高，可以考虑用依赖注入的方式把*sql.DB传下去，这样可测试性更好。但不管怎么传，核心原则不变：这个实例必须是全局唯一的、被复用的。
• 别忘了导入驱动。 sql.Open的第一个参数是驱动名称，它必须对应一个已经导入的驱动包。比如用MySQL，就要在代码里导入_ "github.com/go-sql-driver/mysql"。否则你会得到一个"sql: unknown driver"的错误，看着挺基础，但确实容易忽略。

说到底，sql.Open的本质是“初始化连接池”，而不是“打开一个连接”。一次初始化，全程复用，再根据实际负载合理调优连接池参数——这才是Go语言里数据库访问的最佳实践。