调用redis.createClient()出现未知原因Timeout Error报错排查求助

报错根因定位 #

从日志可以看出核心问题是Redis客户端始终无法完成与服务端的连接建立，导致tarn连接池等待获取连接超时触发了报错：

• Redis客户端实例的connected、ready状态均为false
• 底层TCP socket一直处于connecting状态，已经发送了auth认证请求但未收到服务端任何响应
• 连接池在等待获取可用连接的过程中超时

可能的触发原因 #

• 网络连通性受限：客户端所在机器到Redis服务端33694端口的网络不通，可能是安全组/防火墙未放开对应端口的出入站规则，也可能是ip-xx-xxx-xx-xx.something域名解析异常、解析结果有误
• Redis服务端连接数耗尽：Redis服务maxclients配置的连接数上限被占满，新的连接请求服务端无响应
• 连接池配置不合理：tarn连接池的acquireTimeout等待超时时间设置过短，连接还未建立完成就被连接池判定为超时
• 加密配置缺失：如果使用的是云厂商托管的Redis服务，大部分要求走TLS加密连接，客户端未配置TLS参数会导致连接被服务端拦截卡住
• 旧版本Redis包缺陷：你使用的v3版本redis npm包存在连接逻辑兼容性bug，在特定Node.js版本下会出现连接建立卡住的问题

排查解决步骤 #

• 先验证网络连通性：在服务部署的机器上执行命令测试连接：

# 用redis-cli测试
redis-cli -h ip-xx-xxx-xx-xx.something -p 33694 -a "你的Redis密码" ping
# 或者用telnet测试端口连通性
telnet ip-xx-xxx-xx-xx.something 33694

如果返回PONG或者telnet能连上说明网络正常，否则优先排查防火墙、安全组、域名解析配置。

• 检查Redis服务端状态：登录Redis服务端执行命令：

# 查看当前连接数
client list | wc -l
# 查看连接数上限
config get maxclients

如果当前连接数接近上限，调整maxclients配置，同时排查是否存在连接泄露问题。

• 调整配置参数：
  1. 调大tarn连接池的acquireTimeout参数，建议设置为10000（10秒）
  2. 给Redis客户端添加显式超时配置和错误监听：

const client = redis.createClient(process.env.REDIS_URL, {
  connect_timeout: 10000,
  enable_ready_check: true,
  // 如果是云Redis需要TLS连接加下面配置
  // tls: {}
});
// 增加错误事件监听，打印具体连接错误
client.on('error', err => {
  console.error('Redis连接错误：', err);
});

• 升级Redis包：如果当前使用的是v3版本的redis npm包，建议升级到v4稳定版本，v4版本连接逻辑更稳定，错误提示更清晰。
• 排查连接泄露：检查消费逻辑中获取的Redis连接是否正常释放回连接池，未释放的连接会快速占满连接池，导致新的请求无法获取连接超时。

内容的提问来源于stack exchange，提问作者Himanshu Shekhar