Node Redis闲置数分钟后抛出read ETIMEDOUT错误求助

这种超时错误的核心原因是：Redis服务端或者中间网络设备（防火墙、代理）会主动断开长时间无活动的连接，而默认的客户端配置既没有处理连接断开后的自动重连，也没有配置心跳机制维持连接活性，最终导致闲置后再操作时触发超时，甚至直接拖垮应用。

以下是针对性的解决方案：

1. 配置自动重连与错误捕获 #

Redis客户端支持自动重连策略，同时必须显式捕获错误事件，避免未处理的异常导致Node.js进程崩溃。

2. 启用心跳机制 #

通过定期发送PING命令保持连接活跃，防止被网络设备判定为闲置连接而断开。

修改后的客户端初始化代码 #

const redis = require('redis');

const client = redis.createClient({
  url: "redis://default:user@123.123.12.123:6379",
  // 重连策略：重试间隔随次数递增，最大延迟500ms
  retryStrategy: (times) => Math.min(times * 50, 500),
  // 就绪检查：确保连接正常后再执行命令
  enableReadyCheck: true,
  // 单个请求的最大重试次数
  maxRetriesPerRequest: 3,
  // 心跳间隔：每10秒发送一次PING维持连接
  keepAlive: 10000
});

// 捕获客户端错误，避免进程崩溃
client.on('error', err => {
  console.error('Redis错误:', err);
});

// 监听重连事件，便于排查连接状态
client.on('reconnecting', () => {
  console.log('Redis正在重连...');
});

module.exports = client;

额外注意事项 #

• 如果你使用的是node-redis v3及更早版本，keepAlive参数需要通过client.setKeepAlive(10000)方法手动设置，而非在初始化配置中添加。
• 确认Redis服务端的timeout配置（默认是0，即不主动断开），如果服务端配置了超时，客户端心跳间隔要小于该值。

内容的提问来源于stack exchange，提问作者Serhii Zharkov