Redis连接失败后hGet无响应问题求助（npm包版本差异）

核心原因 #

redis@4.6.x默认开启了自动重连+未完成命令自动重试机制，连接断开后新发送的命令会排队等待重连成功，导致请求陷入无限等待；而4.0.1版本在连接失败时会直接拒绝命令并抛出错误。

以下是几种可行的处理方案：

1. 全局配置连接/命令超时 #

创建Redis客户端时显式设置超时参数，让失败的命令在指定时间内抛出错误，而非无限等待：

import { createClient } from 'redis';

const client = createClient({
  url: 'redis://your-redis-host:6379',
  connectTimeout: 5000,  // 连接超时时间（毫秒）
  commandTimeout: 3000,  // 命令执行超时时间（毫秒）
});

await client.connect();

2. 监听连接状态，提前拦截无效命令 #

维护一个连接状态标记，执行hGet前先检查连接是否正常，避免无效命令进入排队：

import { createClient } from 'redis';

const client = createClient({ url: 'redis://your-redis-host:6379' });
let isRedisConnected = false;

// 监听连接状态
client.on('ready', () => {
  isRedisConnected = true;
});

client.on('error', () => {
  isRedisConnected = false;
});

await client.connect();

// 封装安全的hGet方法
async function safeHGet(key, field) {
  if (!isRedisConnected) {
    throw new Error('Redis连接已断开，无法执行命令');
  }
  return await client.hGet(key, field);
}

3. 禁用自动重试（还原旧版本行为） #

如果不需要自动重连和命令重试，可以关闭相关配置，让连接失败时直接抛出错误：

import { createClient } from 'redis';

const client = createClient({
  url: 'redis://your-redis-host:6379',
  autoResubscribe: false,        // 关闭自动重新订阅
  autoResendUnfulfilledCommands: false,  // 关闭未完成命令自动重试
});

await client.connect();

4. 单个命令手动设置超时 #

用Promise.race给特定hGet请求单独设置超时，不影响全局配置：

async function hGetWithTimeout(key, field, timeout = 3000) {
  const timeoutPromise = new Promise((_, reject) => {
    setTimeout(() => reject(new Error('hGet命令执行超时')), timeout);
  });
  return await Promise.race([client.hGet(key, field), timeoutPromise]);
}

内容的提问来源于stack exchange，提问作者Sai Dheeraj Paluvadi