使用Docker部署Redis时遇ERR max number of clients reached错误求助

1. 先确认当前连接状态与限制 #

• 进入Docker容器内的Redis命令行：

  docker exec -it <你的Redis容器名/ID> redis-cli
  

• 查看当前已连接客户端数量：

  INFO clients
  

  重点看connected_clients字段，确认是否接近或达到上限
• 查看Redis当前配置的最大客户端数：

  CONFIG GET maxclients
  

2. 临时调整最大客户端数（重启容器后失效） #

在Redis命令行中执行以下命令，直接修改运行时配置（数值根据服务器资源调整，比如设为20000）：

CONFIG SET maxclients 20000

3. 永久修改最大客户端限制 #

方法一：修改Redis配置文件 #

• 找到Redis的redis.conf配置文件（如果是Docker挂载的宿主机文件，直接编辑；如果是容器内文件，先拷贝出来修改再挂载）
• 找到maxclients配置项，修改为目标数值：

  maxclients 20000
  

• 重启Redis容器：

  docker restart <你的Redis容器名/ID>
  

方法二：通过Docker启动参数指定 #

• 用docker run启动时添加参数：

  docker run --name redis -d redis redis-server --maxclients 20000
  

• 用docker-compose的话，在服务配置中添加命令参数：

  services:
    redis:
      image: redis
      command: redis-server --maxclients 20000
  

4. 调整系统文件句柄限制（关键） #

Redis的maxclients不能超过系统给进程分配的文件句柄上限，否则设置会不生效：

• 查看容器内当前的文件句柄限制：

  docker exec -it <容器名/ID> ulimit -n
  

• 如果数值低于你设置的maxclients，需要调整Docker的ulimit参数：
  • Docker run方式：

    docker run --name redis -d --ulimit nofile=65536:65536 redis redis-server --maxclients 20000
    

  • Docker-compose方式：

    services:
      redis:
        image: redis
        command: redis-server --maxclients 20000
        ulimits:
          nofile:
            soft: 65536
            hard: 65536
    

5. 排查客户端连接泄漏 #

• 在Redis命令行执行CLIENT LIST，查看所有连接的状态，找出长时间空闲、未正常关闭的连接
• 检查你的ioredis代码：
  • 确认是否正确配置了连接池，避免创建过多连接
  • 检查是否有未释放的连接，比如请求结束后没有归还给连接池
  • 可以设置连接的超时时间，自动回收空闲连接

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