2. Go 标准库 database/sql 连接池机制

Go 标准库 database/sql 是几乎所有 Go 数据库驱动的基石。它内置了一个高效、可配置的连接池，开发者无需手动管理连接生命周期。理解其核心结构体 sql.DB 以及连接池的默认行为，是进行性能调优的第一步。

2.1 sql.DB 结构体：连接池的“大脑”

sql.DB 并非一个单一的数据库连接，而是一个连接池的抽象。它负责管理一组可复用的数据库连接，并处理并发安全、连接创建、空闲回收等复杂逻辑。其核心字段（非公开，但行为可通过参数控制）包括：

2.2 连接池的默认行为

如果不进行任何配置，直接使用 sql.Open() 创建的 sql.DB 实例，其行为如下：

• MaxOpenConns = 0：表示对最大打开连接数没有限制。理论上可以创建无限多个连接，直到数据库或系统资源耗尽。
• MaxIdleConns = 2：默认最多保留 2 个空闲连接。如果空闲连接超过此数，多余的会被关闭并释放。
• ConnMaxLifetime = 0：连接永不超时，除非显式关闭或发生网络错误。
• ConnMaxIdleTime = 0：空闲连接永不超时，会一直保留在池中。

下图展示了连接池在默认配置下的工作流程：

2.3 MaxOpenConns 参数详解

定义： SetMaxOpenConns(n int) 设置连接池中最大打开连接数，包括正在使用和空闲的连接。

• n <= 0：不限制连接数（默认值）。
• n > 0：限制最大连接数为 n。当所有连接都在忙时，新的数据库操作会阻塞，直到有连接被归还到池中。

2.4 MaxIdleConns 参数详解

定义： SetMaxIdleConns(n int) 设置连接池中最大空闲连接数。

• n <= 0：不保留任何空闲连接（不推荐，会导致频繁创建和关闭连接）。
• n > 0：最多保留 n 个空闲连接。如果空闲连接超过 n，多余的会被关闭。

2.5 参数对比与配置策略

下图展示了不同参数配置下连接池的行为差异：

2.6 代码示例：参数设置

package main

import (
    "database/sql"
    "time"
    _ "github.com/go-sql-driver/mysql"
)

func main() {
    db, err := sql.Open("mysql", "user:password@tcp(127.0.0.1:3306)/dbname")
    if err != nil {
        panic(err)
    }
    defer db.Close()

    // 设置最大打开连接数
    db.SetMaxOpenConns(100)

    // 设置最大空闲连接数
    db.SetMaxIdleConns(20)

    // 设置连接最大存活时间
    db.SetConnMaxLifetime(30 * time.Minute)

    // 设置连接最大空闲时间
    db.SetConnMaxIdleTime(5 * time.Minute)

    // 验证连接是否可用
    if err = db.Ping(); err != nil {
        panic(err)
    }
}