Keyv项目中的Redis连接异常处理与最佳实践

问题背景

在使用Keyv与Redis集成时，开发者经常会遇到"Socket closed unexpectedly"错误，导致应用进程意外终止。这个问题尤其在使用NestJS框架和cache-manager时更为常见。

问题现象

当Redis连接意外中断时，开发者期望通过配置的reconnectStrategy策略自动重连，但实际情况是进程直接崩溃退出，错误信息如下：

Error: Socket closed unexpectedly
    at Socket.<anonymous> (node_modules/@redis/client/dist/lib/client/socket.js:194:118)

根本原因分析

经过深入排查，发现导致该问题的主要原因有两点：

1. 初始化方式不正确：开发者直接实例化KeyvRedis而没有正确包装在Keyv中
2. 错误处理缺失：没有为Redis连接设置错误监听器

解决方案

正确的初始化方式

推荐使用以下两种方式之一来正确初始化Keyv与Redis的连接：

方式一：显式初始化

const redisOptions = {
  url: 'redis://localhost:6379',
  socket: {
    reconnectStrategy: (retries) => Math.min(retries * 50, 2000)
  }
};
const client = createClient(redisOptions);
const keyvRedis = new KeyvRedis(client);
const keyv = new Keyv(keyvRedis);

方式二：使用便捷方法

import { createKeyv } from '@keyv/redis';

const keyv = createKeyv({
  url: 'redis://localhost:6379',
  socket: {
    reconnectStrategy: (retries) => Math.min(retries * 50, 2000)
  }
});

完善的错误处理

必须为Redis连接添加错误监听器，否则连接错误会导致进程崩溃：

keyv.on('error', (error) => {
  console.error('Redis连接错误:', error);
});

最佳实践

重连策略配置

推荐配置合理的重连策略，避免无限重试或过于频繁的重连：

const redisReconnectOptions = {
  maxAttempts: 5,
  minConnectDelay: 5000,
  maxConnectDelay: 30000
};

const reconnectStrategy = (attempts) => {
  if (attempts > redisReconnectOptions.maxAttempts) {
    console.error('Redis重连次数过多，终止进程');
    process.exit(1);
  }
  const wait = Math.min(
    redisReconnectOptions.minConnectDelay * Math.pow(2, attempts),
    redisReconnectOptions.maxConnectDelay
  );
  console.log(`将在${wait/1000}秒后尝试重连`);
  return wait;
};

生产环境建议

1. 监控连接状态：监听connect/disconnect事件，记录连接状态变化
2. 优雅降级：当Redis不可用时，考虑使用内存缓存作为后备方案
3. 健康检查：实现健康检查端点，监控Redis连接状态
4. 日志记录：详细记录连接事件和错误，便于问题排查

注意事项

1. 在NestJS中使用时，确保正确注入CacheModule
2. 避免在多个地方创建Redis连接，应该共享连接实例
3. 注意TTL单位，不同版本的cache-manager可能使用秒或毫秒
4. 处理undefined值时，考虑转换为null以避免序列化问题

通过遵循这些最佳实践，可以构建健壮的Redis缓存层，有效处理连接中断等异常情况，保证应用的稳定性。