2、连接池基础回顾：Go标准库database/sql的连接池模型、SetMaxOpenConns、SetMaxIdleConns、SetConnMaxLifetime

在深入事务与水位接口契约之前，必须重新理解 Go 标准库 database/sql 的连接池模型。它不仅是所有数据库交互的基石，也是事务隔离与连接复用的核心战场。本章从连接池的三大核心参数出发，拆解其内部状态机与水位控制逻辑。

2.1 连接池模型：从请求到复用的闭环

database/sql 的连接池是一个无锁化 + 通道驱动的并发安全池。每个 sql.DB 实例维护一个连接队列，所有操作（获取、释放、关闭）均通过内部 channel 与互斥锁协调。其核心状态包括：

• 空闲连接（Idle）：已建立但未被使用的连接，存放在 freeConn 列表中。
• 活跃连接（Open）：当前正在被 goroutine 使用的连接。
• 等待队列（Wait）：当活跃连接数达到上限时，请求者进入 connRequests 通道等待。
• 最大打开连接数（MaxOpen）：硬性上限，控制池的总水位。
• 最大空闲连接数（MaxIdle）：控制空闲连接的水位，避免资源浪费。
• 连接最大存活时间（MaxLifetime）：连接的生命周期，到期后自动关闭。

2.2 三大核心参数：水位控制的三把闸门

Go 标准库通过三个方法控制连接池的水位与生命周期。理解它们的交互关系是避免连接泄漏、死锁和性能瓶颈的关键。

2.3 参数交互与水位变化

三个参数并非独立工作，它们共同决定连接池的瞬时水位与长期水位。以下是一个典型的高并发场景下的水位变化流程：

1. 初始化：连接池为空，MaxOpen=100，MaxIdle=10，MaxLifetime=5min。
2. 突发流量：100 个并发请求同时到达，空闲池为空，连接池创建 100 个新连接，活跃连接数达到 100。
3. 请求完成：前 10 个请求完成，释放连接。空闲池接收 10 个连接（达到 MaxIdle），其余 90 个连接被直接关闭。
4. 持续流量：后续请求从空闲池获取连接，无需新建。空闲池水位在 0~10 之间波动。
5. 连接过期：5 分钟后，空闲池中的连接因 MaxLifetime 到期被关闭，触发新建连接。

2.4 代码示例：参数配置与监控

以下是一个生产级连接池配置示例，包含参数设置与运行时监控：

package main

import (
    "database/sql"
    "fmt"
    "log"
    "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 {
        log.Fatal(err)
    }

    // 配置连接池参数
    db.SetMaxOpenConns(100)          // 最大打开连接数
    db.SetMaxIdleConns(10)           // 最大空闲连接数
    db.SetConnMaxLifetime(5 * time.Minute) // 连接最大存活时间

    // 启动监控 goroutine
    go func() {
        ticker := time.NewTicker(10 * time.Second)
        for range ticker.C {
            stats := db.Stats()
            fmt.Printf("Open: %d, InUse: %d, Idle: %d, WaitCount: %d, WaitDuration: %v\n",
                stats.OpenConnections,
                stats.InUse,
                stats.Idle,
                stats.WaitCount,
                stats.WaitDuration,
            )
        }
    }()

    // 业务逻辑...
    _ = db
}

2.5 常见陷阱与最佳实践