数据库连接池怎么配置？TiDB JDBC/ORM 最佳连接管理实践

摘要

连接池配置直接影响 TiDB 应用的性能、稳定性和资源利用率。配置过小导致请求排队，配置过大造成数据库连接资源耗尽。本文从 TiDB 连接模型出发，系统讲解 HikariCP、Druid、c3p0 等主流连接池的配置要点，以及 MyBatis、Hibernate、GORM 等 ORM 框架的连接管理最佳实践。

本文适合谁： 使用 Java/Go/Python 等 TiDB 应用的后端开发者、DBA，以及需要优化数据库连接性能和稳定性的架构师。

一、连接池概念与价值

1.1 为什么需要连接池

数据库连接的创建和销毁是昂贵的操作：

无连接池：
请求 → TCP 三次握手 → MySQL 认证 → TLS 协商 → 执行 SQL → 关闭连接
       每次请求都重复上述流程，延迟 5-50ms

有连接池：
启动时 → 预创建 N 个连接放入池中
请求 → 从池中取连接（< 1ms）→ 执行 SQL → 归还连接池
       连接复用，避免重复建连开销

1.2 连接池核心参数

二、TiDB 连接模型

2.1 TiDB Server 连接架构

TiDB 作为无状态的 SQL 层，每个客户端连接由一个 TiDB Server 节点处理：

应用服务器                    TiDB 集群
┌──────────┐              ┌──────────────┐
│ 连接池     │─TCP 连接 1──▶│ TiDB-Server-1 │──▶ PD（元数据）
│ (10连接)  │─TCP 连接 2──▶│              │
│          │─...          ├──────────────┤
│          │              │ TiDB-Server-2 │──▶ TiKV（数据存储）
│          │─TCP 连接 N──▶│              │
└──────────┘              └──────────────┘

TiDB 连接相关参数：

2.2 连接数估算公式

总连接数 = 应用实例数 × 每实例连接池大小 + 预留连接数

示例：
- 10 个应用实例
- 每实例连接池大小 20
- 预留监控/运维连接 10
- 总连接数 = 10 × 20 + 10 = 210

TiDB Server 单节点建议上限：3000-5000 连接

三、主流连接池配置

3.1 HikariCP（推荐）

HikariCP 是目前性能最高的 JDBC 连接池，Spring Boot 默认使用。

# application.properties — HikariCP 配置（TiDB 最佳实践）

spring.datasource.url=jdbc:mysql://tidb-server:4000/mydb? \
  sslMode=DISABLED& \
  allowPublicKeyRetrieval=true& \
  useServerPrepStmts=true& \
  cachePrepStmts=true& \
  prepStmtCacheSize=256& \
  prepStmtCacheSqlLimit=2048& \
  useCursorFetch=true

spring.datasource.username=root
spring.datasource.password=your_password
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

# HikariCP 核心 参数
spring.datasource.hikari.maximum-pool-size=20
spring.datasource.hikari.minimum-idle=10
spring.datasource.hikari.connection-timeout=30000
spring.datasource.hikari.idle-timeout=600000
spring.datasource.hikari.max-lifetime=1800000
spring.datasource.hikari.validation-timeout=5000
spring.datasource.hikari.leak-detection-threshold=60000

3.2 Druid

Druid 是阿里巴巴开源的连接池，提供丰富的监控功能。

# Druid 配置
spring.datasource.druid.url=jdbc:mysql://tidb-server:4000/mydb
spring.datasource.druid.username=root
spring.datasource.druid.password=your_password
spring.datasource.druid.driver-class-name=com.mysql.cj.jdbc.Driver

spring.datasource.druid.initial-size=10
spring.datasource.druid.min-idle=10
spring.datasource.druid.max-active=50
spring.datasource.druid.max-wait=30000

# TiDB 场景关键配置
spring.datasource.druid.time-between-eviction-runs-millis=60000
spring.datasource.druid.min-evictable-idle-time-millis=300000
spring.datasource.druid.max-evictable-idle-time-millis=1800000
spring.datasource.druid.validation-query=SELECT 1
spring.datasource.druid.test-while-idle=true
spring.datasource.druid.test-on-borrow=false
spring.datasource.druid.test-on-return=false

3.3 c3p0

c3p0 功能全面但性能不如 HikariCP，仅建议在遗留项目中使用。

<!-- c3p0 配置 -->
<property name="jdbcUrl">jdbc:mysql://tidb-server:4000/mydb</property>
<property name="user">root</property>
<property name="password">your_password</property>
<property name="driverClass">com.mysql.cj.jdbc.Driver</property>
<property name="initialPoolSize">10</property>
<property name="minPoolSize">10</property>
<property name="maxPoolSize">50</property>
<property name="acquireIncrement">5</property>
<property name="maxIdleTime">600</property>
<property name="maxConnectionAge">1800</property>
<property name="preferredTestQuery">SELECT 1</property>
<property name="testConnectionOnCheckout">false</property>
<property name="testConnectionOnCheckin">false</property>
<property name="idleConnectionTestPeriod">60</property>

3.4 连接池对比

四、ORM 连接管理

4.1 MyBatis + HikariCP

# application.yml
spring:
  datasource:
    url: jdbc:mysql://tidb-server:4000/mydb?useSSL=false&useServerPrepStmts=true&cachePrepStmts=true
    username: root
    password: your_password
    driver-class-name: com.mysql.cj.jdbc.Driver
    hikari:
      maximum-pool-size: 20
      minimum-idle: 20
      max-lifetime: 1800000
      connection-timeout: 30000

mybatis:
  configuration:
    default-fetch-size: 1000
    default-statement-timeout: 30
  mapper-locations: classpath:mapper/*.xml

4.2 Hibernate / Spring Data JPA

# TiDB + Hibernate 注意事项
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect
spring.jpa.properties.hibernate.connection.provider_disables_autocommit=true
spring.jpa.properties.hibernate.jdbc.batch_size=50
spring.jpa.properties.hibernate.order_inserts=true
spring.jpa.properties.hibernate.order_updates=true
spring.jpa.properties.hibernate.jdbc.lob.non_contextual_creation=true

# 连接池通过 HikariCP 管理，JPA 不额外配置连接池

4.3 GORM（Go）+ database/sql

package main

import (
    "database/sql"
    "fmt"
    "time"
    "gorm.io/driver/mysql"
    "gorm.io/gorm"

    _ "github.com/go-sql-driver/mysql"
)

func main() {
    dsn := "root:password@tcp(tidb-server:4000)/mydb? \
        parseTime=true& \
        tls=false& \
        readTimeout=30s& \
        writeTimeout=30s"

    // Go database/sql 内置连接池
    db, err := sql.Open("mysql", dsn)
    if err != nil {
        panic(err)
    }

    // 连接池配置
    db.SetMaxOpenConns(50)       // 最大连接数
    db.SetMaxIdleConns(25)       // 最大空闲连接数
    db.SetConnMaxLifetime(30 * time.Minute) // 连接最大生存时间
    db.SetConnMaxIdleTime(10 * time.Minute)  // 空闲连接最大生存时间

    // GORM 包装
    gormDB, err := gorm.Open(mysql.New(mysql.Config{
        Conn: db,
    }), &gorm.Config{})
    if err != nil {
        panic(err)
    }

    fmt.Println("TiDB GORM connection pool initialized")
}

Go database/sql 连接池参数：

五、TiDB 连接池最佳实践

5.1 连接池大小计算

最佳连接数 = (CPU 核心数 × 2) + 有效磁盘数

应用端公式（HikariCP 作者推荐）：
connections = ((core_count * 2) + effective_spindle_count)

TiDB 集群公式：
总连接数 = max_connections × TiDB Server 节点数

示例：
- 8 核 CPU 应用服务器 × 2 = 16 连接
- 3 个 TiDB Server，每个 max_connections = 3000
- 集群总连接数上限 = 9000

5.2 常见问题排查

-- 查看当前 TiDB 连接数
SHOW STATUS LIKE 'Threads_connected';

-- 查看连接来源分布
SELECT user, host, db, command, time
FROM information_schema.processlist
ORDER BY time DESC;

-- 查看各应用连接数
SELECT SUBSTRING_INDEX(host, ':', 1) AS client_ip,
       COUNT(*) AS conn_count
FROM information_schema.processlist
GROUP BY client_ip
ORDER BY conn_count DESC;

5.3 JDBC URL 关键参数

jdbc:mysql://tidb-server:4000/mydb?\
  useSSL=false\                          # 内网场景关闭 SSL 减少延迟
  useServerPrepStmts=true\               # 使用服务端预处理语句
  cachePrepStmts=true\                   # 缓存预处理语句
  prepStmtCacheSize=256\                 # 缓存大小
  prepStmtCacheSqlLimit=2048\            # 单条缓存上限
  useCursorFetch=true\                   # 游标读取大结果集
  defaultFetchSize=1000\                  # 默认 fetch 大小
  socketTimeout=30000\                   # Socket 超时
  connectTimeout=10000                   # 连接超时

FAQ

Q1：TiDB 推荐的最大连接数是多少？

TiDB 单节点连接数上限由 `max_connections` 控制（默认无限制，建议设为 3000-5000）。集群总连接数为各节点之和。实际建议根据应用实例数和每实例池大小计算总连接数，避免超过 PD 和 TiKV 的承载能力。

Q2：连接池泄漏如何检测和处理？

HikariCP 提供泄漏检测功能：配置 `leak-detection-threshold=60000`（60秒），超过阈值未归还的连接会记录堆栈日志。Druid 提供类似功能（`removeAbandoned=true`）。处理方式：检查代码中是否遗漏了连接关闭（未使用 try-with-resources）、是否在事务中执行耗时操作导致连接长时间持有。

Q3：TiDB 集群扩容后需要调整连接池吗？

TiDB Server 无状态，增加节点后应用可通过负载均衡自动分配连接到新节点。不需要调整应用端连接池大小。但如果总连接数即将超过单 TiDB Server 的 `max_connections` 上限，需要相应扩容 TiDB Server 节点。

Q4：连接池和 TiDB Serverless 的连接限制如何协调？

TiDB Cloud Serverless 对连接数有明确限制（取决于套餐）。应用端连接池的 `maximum-pool-size` 应控制在 Serverless 限制内，并设置合理的 `connection-timeout` 处理排队情况。建议 Serverless 场景 `maximum-pool-size` 不超过 50。

总结

TiDB 连接池配置的核心在于根据应用并发量和 TiDB 集群规模合理设定连接数，同时配置超时、回收和验证参数保障连接可靠性。HikariCP 是 Java 应用的首选连接池，Go 应用使用 `database/sql` 内置连接池即可满足需求。正确配置连接池可将应用数据库访问延迟稳定在 1-5ms 水平，避免连接数耗尽导致的级联故障。

下一步行动

1. 试用 TiDB：在 TiDB Cloud Serverless 免费创建集群，按本文配置连接池并验证性能
2. 下载连接池最佳实践文档：访问 TiDB 应用开发指南 获取完整连接管理手册
3. 获取 TiDB 性能调优方案：访问 TiDB 性能诊断与调优 了解更多优化手段

相关资源

• TiDB 应用开发最佳实践
• HikariCP 官方 Wiki — 关于池大小
• TiDB Cloud 免费试用
• TiDB Go 客户端文档
• TiDB Java 客户端（MySQL Connector/J）配置