连接超时:数据库不可达
快速摘要
你的应用尝试连接数据库但连接超时 —— 服务器可能已关闭或网络被阻止。
为什么发生
数据库服务器已关闭或未在预期端口上监听
防火墙或网络问题阻止了应用与数据库之间的连接
连接池已耗尽,在超时时间内没有可用连接
最小示例
✗ 错误代码
const pool = createPool({ host: 'db.example.com', port: 5432, connectionTimeoutMillis: 1000 });
const client = await pool.connect(); // throws ConnectionTimeoutError✓ 修复代码
const pool = createPool({ host: 'db.example.com', port: 5432, connectionTimeoutMillis: 5000, max: 20 });
async function getClientWithRetry() {
for (let i = 0; i < 3; i++) {
try { return await pool.connect(); }
catch (e) { await new Promise(r => setTimeout(r, 1000 * 2 ** i)); }
}
throw new Error('DB unavailable after retries');
}增大超时时间并添加带指数退避的重试逻辑可以优雅地处理瞬时连接失败。
如何诊断
通过 ping 或 telnet 到主机和端口验证数据库服务器是否正在运行
检查连接字符串中的主机、端口和凭据是否正确
查看连接池设置和当前活动连接数
如何修复
启动数据库服务器或联系数据库管理员
修复网络连接或防火墙规则以允许连接
增大连接池大小或连接超时时间,并添加带指数退避的重试逻辑
如何预防
使用带健康检查和自动重连的连接池
监控数据库连接状况并设置连接失败告警