1. 连接池基础概念

1.1 什么是数据库连接池

数据库连接池（Connection Pool）是一种在应用启动时预先创建一定数量的数据库连接，并将其保存在“池”中供后续请求复用的技术。当 Go Web 服务需要执行 SQL 查询时，不再每次都经历“TCP 三次握手 → MySQL 认证 → 资源分配 → 使用 → 关闭”的完整生命周期，而是从池中取出一个空闲连接直接使用，用完后归还到池中。

1.2 为什么需要连接池

在 Go Web 服务中，每次数据库操作都新建连接会带来严重的性能问题。以下对比表清晰展示了有无连接池的差异：

1.3 连接池核心参数

Go 标准库 database/sql 中的 sql.DB 对象提供了四个核心参数来控制连接池行为。理解每个参数的作用是调优的基础。

1.4 参数配置示例

以下是一个典型的 Go 连接池配置代码，展示了如何设置上述四个参数：

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

func InitDB(dsn string) (*sql.DB, error) {
    db, err := sql.Open("mysql", dsn)
    if err != nil {
        return nil, err
    }

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

    // 设置最大空闲连接数（通常为 MaxOpenConns 的 70%）
    db.SetMaxIdleConns(70)

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

    // 设置连接最大空闲时间（10 分钟）
    db.SetConnMaxIdleTime(10 * time.Minute)

    // 测试连接是否可用
    if err = db.Ping(); err != nil {
        return nil, err
    }

    return db, nil
}

1.5 参数间的关系与影响

四个参数并非独立工作，它们共同决定了连接池的行为特征。下面的 SVG 图展示了参数之间的协作关系：

1.6 参数配置速查表

根据不同的业务场景，推荐以下初始配置模板：