连接池耗尽
快速摘要
你的连接池没有可用连接 —— 所有连接都被借出,获取请求超时了。
为什么发生
由于缺少关闭/归还调用,使用后连接未归还到连接池
连接池大小对于应用的并发负载来说太小
长时间运行的查询长时间持有连接,使其他请求饥饿
最小示例
✗ 错误代码
app.get('/users', async (req, res) => {
const client = await pool.connect();
const users = await client.query('SELECT * FROM users');
res.json(users);
// missing client.release() — connection leaked!
});✓ 修复代码
app.get('/users', async (req, res) => {
const client = await pool.connect();
try {
const users = await client.query('SELECT * FROM users');
res.json(users);
} finally {
client.release(); // always released
}
});使用 try/finally 释放连接确保即使查询或响应失败,连接也归还到连接池,防止连接池耗尽。
如何诊断
检查连接池统计信息中的总连接、空闲连接和活动连接以确认耗尽
查看代码中获取但未在所有代码路径中释放的连接
监控查询执行时间以识别长时间持有连接的慢查询
如何修复
确保所有获取的连接在 finally 块中释放
增大连接池最大大小以处理峰值并发负载
优化慢查询或将长时间运行的操作移到有独立连接池的单独工作线程
如何预防
始终在 finally 块中释放连接或使用自动释放的连接池辅助函数
根据预期并发负载设置连接池大小并监控连接池使用情况