已设置Redis connectTimeout但客户端仍存活，求排查原因

我在项目中使用ioredis连接Redis，发现部分客户端长时间未关闭，因此为每个Redis客户端添加了connectTimeout（值为10000）和connectionName属性用于标识，连接代码如下：

const redis = new Redis({
  host: process.env.REDIS_HOST,
  port: process.env.REDIS_PORT,
  password: process.env.REDIS_PASSWORD,
  username: process.env.REDIS_USERNAME,
  db: process.env.REDIS_DB,
  connectTimeout: 10000,
  connectionName: connectionName,
});

但通过Redis CLI执行CLIENT LIST命令后，仍能看到部分客户端的空闲时间超过10000毫秒，connectTimeout似乎未生效。

• 对connectTimeout的作用理解偏差：这个参数仅控制TCP连接建立阶段的超时——当客户端尝试和Redis服务器建立连接时，如果10秒内没成功建立就会抛错终止连接。它完全不负责连接成功后的空闲超时管理，所以连接建立后即使空闲很久，这个参数也不会触发断开。
• 空闲客户端未被清理的核心原因：ioredis本身不会自动断开空闲连接，Redis服务器默认也不会主动踢掉空闲客户端（默认timeout配置为0，即永不超时）。你看到的长时间空闲客户端，要么是客户端没主动释放，要么是服务器没配置空闲清理规则。

1. 配置Redis服务器的空闲超时：在Redis配置文件中设置timeout 10（单位是秒，代表10秒空闲后断开连接），或者通过Redis CLI执行CONFIG SET timeout 10临时生效。服务器会主动清理超过设定时间的空闲客户端。
2. 客户端层面实现空闲断开：
   • 如果使用ioredis连接池（推荐），可以配置idleTimeoutMillis参数，让连接池自动回收空闲连接：

     const Redis = require('ioredis');
     const redis = new Redis({
       // 原有配置...
       connectTimeout: 10000,
       connectionName: connectionName,
       // 连接池配置
       maxRetriesPerRequest: 3,
       connectionPool: {
         max: 15, // 最大连接数
         min: 2, // 最小空闲连接数
         idleTimeoutMillis: 10000, // 空闲10秒后回收连接
       },
     });
     

   • 若未使用连接池，可在业务逻辑完成后主动调用redis.quit()（优雅关闭，等待命令执行完毕）或redis.disconnect()（强制关闭）释放连接，避免连接泄漏。
3. 排查连接泄漏点：检查代码中是否存在创建Redis客户端后未主动关闭的场景，比如异常分支未处理连接关闭、单例客户端被重复创建等。

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