概述
本文档基于MySQL服务器配置,详细说明如何优化应用层的数据库连接池参数,确保数据库连接的高效、稳定和安全运行。
MySQL服务器配置参考
[mysqld]
max_connections = 100 # 服务器最大并发连接数
innodb_buffer_pool_size = 640M # InnoDB缓冲池大小
max_allowed_packet = 16M # 最大数据包大小
key_buffer_size = 8M # MyISAM索引缓冲区(仅MyISAM有效)
thread_cache_size = 16 # 线程缓存大小
连接池核心配置详解
1. 基础连接配置
user, host, database, password, port
作用:数据库连接的基础认证信息
说明:从环境变量DATA_SOURCE_URL解析获取,确保敏感信息的安全存储。
2. 字符集配置
charset: 'utf8mb4'
作用:设置客户端连接的字符集
重要性:⭐⭐⭐⭐⭐
配置说明:
utf8mb4是MySQL中真正的UTF-8实现,支持完整的Unicode字符集- 支持emoji、特殊符号等4字节字符
- 与服务器配置
character-set-server = utf8mb4保持一致,避免字符转换 - 不设置可能导致使用默认的
latin1,造成中文乱码问题
3. 时区配置
timezone: '+08:00'
作用:设置客户端连接的时区
重要性:⭐⭐⭐⭐⭐
配置说明:
- 与服务器配置
default-time-zone = '+8:00'保持一致 - 确保应用和数据库使用相同的时区,避免时间数据转换错误
- 例如存储
2025-01-01 12:00:00时,应用和数据库都理解为同一时刻
4. 连接池大小配置
connectionLimit: 50
作用:连接池中同时保持的最大连接数
重要性:⭐⭐⭐⭐⭐
计算依据:
服务器max_connections (100)
- 应用连接池 (50) ← 当前配置
- 其他应用连接 (30) ← 预留
- 管理工具连接 (20) ← 预留(监控、备份、DBA工具等)
= 安全余量
配置建议:
- ✅ 充分利用服务器资源,但不过度占用
- ✅ 为其他应用和管理工具预留足够连接
- ✅ 50个连接足够处理大部分并发场景
- ⚠️ 如果应用是唯一使用者,可适当增加到70-80
- ⚠️ 不建议超过80,以免影响服务器稳定性
5. 等待队列配置
queueLimit: 100
waitForConnections: true
作用:当连接池满时,新请求的处理方式
重要性:⭐⭐⭐⭐
工作流程:
请求到达
↓
连接池有可用连接?
├─ 是 → 立即分配连接并执行
└─ 否 → 队列是否已满?
├─ 否 → 进入等待队列(最多100个)
└─ 是 → 返回错误(连接池忙)
6. 连接保活配置
enableKeepAlive: true
keepAliveInitialDelay: 10000
作用:保持TCP连接活跃,检测网络中断
重要性:⭐⭐⭐⭐
问题场景:
- 连接长时间空闲(如几分钟)
- 中间网络设备(路由器、防火墙、NAT)可能关闭连接
- 应用尝试使用已断开的连接 → 连接错误
解决方案:
enableKeepAlive: true- 启用TCP keepalivekeepAliveInitialDelay: 10000- 10秒后开始发送探测包
7. 空闲连接超时配置
idleTimeout: 60000
作用:连接池中空闲连接的最大存活时间
重要性:⭐⭐⭐
工作原理:
- 连接被释放回连接池后开始计时
- 如果60秒内未被使用,将被关闭
- 下次请求时创建新连接
8. 安全性配置
multipleStatements: false
作用:是否允许一条SQL执行多条语句
重要性:⭐⭐⭐⭐⭐
安全考虑:
false:更安全,防止SQL注入攻击true:允许执行SELECT 1; DROP TABLE users;这样的攻击
建议:始终设置为false,如需批量执行,使用事务或分别执行
9. 日期处理配置
dateStrings: false
作用:日期/时间字段的返回格式
重要性:⭐⭐⭐
说明:
false:返回Date对象,可直接使用(推荐)true:返回字符串,需要手动解析(不推荐)
性能监控与优化
连接池状态监控
// 获取连接池状态
const pool = getDb();
console.log({
totalConnections: pool.pool._allConnections.length,
freeConnections: pool.pool._freeConnections.length,
queuedRequests: pool.pool._connectionQueue.length
});
常见问题及解决方案
连接池频繁满:
- 检查连接泄漏(未正确释放)
- 适当增加
connectionLimit(不超过服务器限制) - 优化慢查询,减少连接占用时间
内存占用过高:
- 减少
connectionLimit - 减少
queueLimit - 减少
idleTimeout
最佳实践
- ✅ 始终使用连接池,不要每次请求创建新连接
- ✅ 使用
withConnection辅助函数,确保连接正确释放 - ✅ 长时间运行的查询考虑使用事务和索引优化
- ✅ 定期监控连接池使用情况
- ✅ 与服务器配置保持一致(字符集、时区)
配置总结
| 配置项 | 值 | 依据 | 重要性 |
|---|---|---|---|
charset |
utf8mb4 |
服务器配置 | ⭐⭐⭐⭐⭐ |
timezone |
+08:00 |
服务器配置 | ⭐⭐⭐⭐⭐ |
connectionLimit |
50 |
服务器max_connections=100 | ⭐⭐⭐⭐⭐ |
queueLimit |
100 |
缓冲突发流量 | ⭐⭐⭐⭐ |
enableKeepAlive |
true |
网络稳定性 | ⭐⭐⭐⭐ |
keepAliveInitialDelay |
10000 |
网络设备超时 | ⭐⭐⭐ |
idleTimeout |
60000 |
资源平衡 | ⭐⭐⭐ |
multipleStatements |
false |
安全性 | ⭐⭐⭐⭐⭐ |
dateStrings |
false |
易用性 | ⭐⭐⭐ |
通过合理的连接池配置,可以有效提升应用性能,确保数据库连接的稳定性和安全性。建议根据实际业务场景和服务器负载情况,定期评估和调整相关参数。