如何避免Redis连接错误导致TypeScript Node.js应用崩溃？

我在TypeScript Node.js应用中使用redis npm包时遇到一个问题：当Redis连接失败（比如触发ECONNREFUSED），不管加多少try-catch块，整个应用都会崩溃，修改client.on("error"...钩子也无法阻止崩溃。

之前找到2016年的一份解决方案代码：

const client = redis.createClient({
  retry_strategy: function (options) {
    if (options.error.code === "ECONNREFUSED") {
      // 抑制ECONNREFUSED未处理异常，避免应用崩溃
      return;
    }
  }
});

但这段代码触发TypeScript错误：

Argument of type '{ retry_strategy: (options: any) => void; }' is not assignable to parameter of type 'RedisClientOptions<RedisModules, RedisFunctions, RedisScripts>'.

就算加上@ts-ignore，这个方案也不生效。我不想改用ioredis，希望继续使用redis包，求解决办法？

适配Redis v4+的正确解决方案 #

现在的redis npm包（v4及以上）已重构API，旧的retry_strategy配置已被废弃，需要用新配置项结合正确的错误监听逻辑解决问题：

1. 配置重试与连接策略

使用socket.retryDelay或socket.reconnectStrategy控制重试行为，在连接被拒绝时停止重试，避免无限重试同时抑制崩溃：

import { createClient, RedisClientOptions } from 'redis';

const clientOptions: RedisClientOptions = {
  socket: {
    host: 'localhost', // 你的Redis地址
    port: 6379, // 你的Redis端口
    // 自定义重试延迟逻辑
    retryDelay: (attempt) => {
      // 获取连接错误信息
      const connError = client.options.socket?.error as NodeJS.ErrnoException;
      // 如果是连接被拒绝，返回undefined停止重试
      if (connError?.code === 'ECONNREFUSED') {
        return undefined;
      }
      // 其他错误按指数退避重试，最长3秒
      return Math.min(attempt * 100, 3000);
    },
    // 可选：限制最大重试次数
    reconnectStrategy: (retries) => {
      const connError = client.options.socket?.error as NodeJS.ErrnoException;
      if (connError?.code === 'ECONNREFUSED' && retries >= 3) {
        // 重试3次后抛出错误，终止重试
        return new Error('Redis连接被拒绝，已达最大重试次数');
      }
      // 每次重试延迟100ms递增
      return retries * 100;
    }
  },
  // 禁用就绪检查，避免连接失败时触发额外错误
  enableReadyCheck: false
};

const client = createClient(clientOptions);

2. 强制注册Error事件处理器

必须确保在创建客户端后立即注册error事件监听，所有Redis相关的未处理错误都会触发这个事件，不监听会直接导致进程崩溃：

client.on('error', (err) => {
  console.error('Redis错误:', err);
  // 这里可以添加自定义逻辑，比如发送告警、切换降级方案等
});

3. 捕获初始连接错误

使用await client.connect()时必须包裹try-catch，捕获首次连接失败的错误：

(async () => {
  try {
    await client.connect();
    console.log('Redis连接成功');
  } catch (err) {
    console.error('Redis初始连接失败:', err);
    // 这里可以选择退出应用或执行降级逻辑
    // process.exit(1);
  }
})();

关键注意点 #

• Redis v4+完全重构了客户端API，旧版本的配置项（如retry_strategy）已被移除，必须使用新的socket下的配置项。
• 无论如何都要注册client.on('error')，这是阻止未处理错误导致进程崩溃的核心。
• 如果需要完全停止重试，在retryDelay中返回undefined，或在reconnectStrategy中返回Error对象（具体行为可参考官方文档）。

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