如何关闭Redis OM连接？解决连接数耗尽问题

一、关闭Redis OM连接的正确方式 #

Redis OM的Client基于Redis官方客户端的连接池实现，关闭连接分两种场景处理：

1. 一次性脚本/短期任务场景 #

任务执行完毕后，直接调用client.close()关闭整个连接池，释放所有资源：

async function runTask() {
  await connect();
  // 执行你的Redis业务操作
  await client.close(); // 任务结束后主动关闭连接池
}

调用close()后，若后续需要再次使用Client，需重新调用open()建立连接。

2. 长期运行服务（如API、后端服务）场景 #

禁止频繁关闭/打开连接，应该复用单例Client的连接池。此时连接数耗尽的核心问题通常是连接池配置不合理，而非需要关闭连接。

二、优化连接池配置解决连接数耗尽 #

在调用client.open()时，可传入连接池配置参数，调整连接池的大小、超时规则，避免连接被耗尽：

const client = new Client();

async function connect() {
  if (!client.isOpen()) {
    await client.open({
      url: process.env.REDIS_URL,
      pool: {
        max: 50, // 最大连接数，需小于Redis服务器的maxclients配置
        min: 5, // 保持的最小空闲连接数
        idleTimeoutMillis: 30000, // 空闲连接30秒后自动释放
        reapIntervalMillis: 1000 // 每秒清理一次空闲连接
      }
    });
  }
}

注意：需确保Redis服务器的maxclients配置值大于等于你设置的max参数，否则会触发服务器端的连接数限制。

三、排查连接耗尽的额外要点 #

• 检查代码中是否创建了多个Client实例，必须保证全局复用同一个单例Client，避免连接数累加
• 确认所有Redis操作的Promise都已正确处理（无未捕获的异常或pending状态），防止连接被占用无法释放
• 可通过Redis命令CLIENT LIST查看当前连接状态，定位异常连接来源

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