连接池基础概念
连接池是BFF聚合层性能的基石。理解其核心概念与参数，是后续进行OpenAPI协同调优的前提。本节将系统梳理连接池的作用、两大类型对比以及关键参数。
1. 连接池的作用
连接池的核心思想是复用。它预先创建并维护一组网络连接（如数据库连接或HTTP连接），当应用需要时从池中“借出”，使用完毕后“归还”，从而避免频繁创建和销毁连接带来的高昂开销。
核心收益：
- 降低延迟：省去TCP三次握手、TLS握手、认证等耗时操作，请求响应时间可降低50%-80%。
- 节省资源：减少操作系统文件描述符、线程、内存的频繁分配与回收。
- 控制并发：通过池大小限制，防止突发流量打垮下游数据库或API服务。
- 提升稳定性：池内连接可进行健康检查，自动剔除失效连接，避免请求失败。
2. 数据库连接池 vs HTTP连接池
BFF层通常同时管理两种连接池：数据库连接池（如HikariCP、Druid）和HTTP连接池（如Apache HttpClient、OkHttp）。两者在用途、协议、生命周期上存在显著差异。
| 对比维度 | 数据库连接池 | HTTP连接池 |
|---|---|---|
| 典型代表 | HikariCP, Druid, DBCP2 | Apache HttpClient, OkHttp, Netty |
| 协议 | TCP + 数据库私有协议（如MySQL协议） | TCP + HTTP/1.1 或 HTTP/2 |
| 连接状态 | 有状态（会话、事务、临时表） | 无状态（每个请求独立） |
| 复用粒度 | 一个连接可串行执行多个SQL | 一个连接可并行发起多个HTTP请求（HTTP/2多路复用） |
| 健康检查 | 需发送心跳SQL（如 SELECT 1） | 通过空闲超时 + 主动探测 |
| 主要瓶颈 | 数据库侧最大连接数限制 | 目标API的QPS限制、DNS解析 |
| BFF典型配置 | maxTotal=10~50 | maxTotal=50~200 |
实战建议：在BFF聚合层中，数据库连接池通常面向内部RDS，连接数不宜过大（避免压垮数据库）；HTTP连接池面向下游微服务或OpenAPI，连接数可适当放大以应对突发流量。
3. 连接池核心参数详解
无论哪种连接池，都围绕四个核心参数进行配置。理解它们的含义与相互关系，是调优的第一步。
| 参数名 | 含义 | 默认值（HikariCP） | 调优方向 |
|---|---|---|---|
| maxTotal (maximumPoolSize) |
池中允许的最大连接数，包括活跃和空闲连接 | 10 | 根据下游承载能力 + 并发量估算 |
| maxIdle | 池中允许保持的最大空闲连接数 | 与maxTotal相同 | 通常等于maxTotal，避免频繁创建 |
| minIdle | 池中保持的最小空闲连接数，低于此值会异步补充 | 0 | 建议设为2~5，应对突发流量 |
| maxWaitMillis | 获取连接时最大等待时间（毫秒），超时抛出异常 | 0（无限等待） | 建议 1000~5000ms，避免线程永久阻塞 |
4. 参数间的联动关系
四个参数并非孤立存在，它们共同决定了连接池的行为模式。
5. 参数配置避坑指南
常见误区：
- maxTotal 设置过大：导致数据库连接数被打满，影响其他服务；或HTTP连接数过多导致目标API限流。
- minIdle 设为 0：流量低谷时所有连接被回收，突发流量时需重新创建，造成延迟尖刺。
- maxWaitMillis 设为 0：当连接池耗尽时，线程将无限期阻塞，可能导致BFF线程池耗尽，引发雪崩。
- maxIdle 远小于 maxTotal：高并发后连接被大量销毁，频繁重建增加开销。
6. 典型配置示例（HikariCP）
# BFF 数据库连接池配置（HikariCP）
spring.datasource.hikari.maximum-pool-size=20
spring.datasource.hikari.minimum-idle=5
spring.datasource.hikari.max-lifetime=1800000
spring.datasource.hikari.idle-timeout=600000
spring.datasource.hikari.connection-timeout=3000
# BFF HTTP 连接池配置（Apache HttpClient）
httpclient.max-total=100
httpclient.default-max-per-route=20
httpclient.connection-timeout=2000
httpclient.socket-timeout=5000
httpclient.connection-request-timeout=3000