升级node-redis到4.0.3后能否正常连接旧版redis-server？

兼容性说明 #

node-redis 4.0.3 最低可兼容Redis 2.6及以上版本，发布超过2年的Redis服务端（对应Redis 6.0及更早版本）完全在兼容范围内，不存在核心协议层面的交互障碍，你遇到的超时、连接关闭问题不属于版本不兼容问题，基本是3.x到4.x配置迁移不完整导致的。

现有初始化代码的问题 #

你当前使用的配置沿用了3.x版本的参数规则，和4.x的配置规范存在几个关键差异，是触发异常的核心原因：

• 3.x版本的auth_pass认证参数在4.x中已被废弃，对应密码配置字段改为根级的password，参数传错会导致客户端始终未完成认证，被服务端主动断开连接，触发连接关闭报错。
• 4.x默认的连接超时、命令超时阈值比3.x更短，旧版服务端如果负载较高响应偏慢，很容易触发默认的超时规则。
• 你当前的TLS配置没有挂载到socket字段下，部分场景下会出现TLS握手异常，导致连接建立失败。
• 4.x客户端不会默认兜底连接错误，如果没有手动绑定error事件监听，连接异常时会直接抛出未捕获错误，表象就是无预兆的连接关闭。

修正后的初始化配置 #

可以直接参考下面的配置调整，覆盖绝大多数旧版服务端对接场景：

var client = redis.createClient({
    // TLS场景使用rediss://前缀，非TLS场景替换为redis://
    url: `rediss://${host}:${port}`,
    password: password, // 替换原auth_pass字段
    socket: {
        tls: true,
        checkServerIdentity: () => undefined,
        connectTimeout: 10000, // 连接超时设置为10秒，适配旧版服务端响应速度
        commandTimeout: 15000, // 命令超时设置为15秒，避免慢查询触发超时
        keepAlive: 5000, // 每5秒发送心跳包，避免被服务端空闲超时机制断开
        reconnectStrategy: (retries) => {
            // 重连间隔递增，最大不超过2秒
            return Math.min(retries * 50, 2000);
        }
    },
    // 如果对接的是Redis 2.6~3.x极老版本，打开下面的兼容模式开关
    // legacyMode: true
});

// 必须绑定error监听，避免未捕获异常导致进程退出
client.on('error', (err) => {
    console.error('Redis client run error:', err);
});

await client.connect();

剩余异常排查方向 #

如果调整配置后问题仍然存在，可以按以下顺序排查：

• 检查Redis服务端配置的timeout参数，如果服务端设置的空闲连接断开时间小于5秒，会主动踢掉空闲连接，对应调大客户端keepAlive的间隔或者修改服务端timeout配置即可。
• 检查服务端是否开启了ACL访问控制，如果是带用户名的认证模式，需要在初始化配置中补充username字段，仅传密码会导致认证失败。
• 检查是否存在大key、慢查询阻塞Redis主线程的情况，服务端阻塞无法响应客户端请求时，也会触发客户端的超时、连接断开报错。

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