Redis容器自定义maxclients配置不生效问题求助

排查步骤与解决方案 #

• 检查配置文件加载状态
  进入容器执行以下命令，确认配置文件是否有效：

  redis-server --check-config /usr/local/etc/redis/redis.conf
  

  同时用redis-cli config get maxclients查看当前生效值，用redis-cli config get config_file确认Redis实际读取的配置文件路径是否为你指定的/usr/local/etc/redis/redis.conf。

• 检查容器文件描述符限制
  Redis的maxclients上限受系统文件描述符限制，容器默认值可能低于50000：

  1. 进入容器执行ulimit -n，如果输出为10000左右，说明是此问题。
  2. 解决方法：
     • 在Dockerfile中添加：RUN ulimit -n 65535
     • 或者启动容器时添加参数：docker run --ulimit nofile=65535:65535 <镜像名>

• 确认redis.conf配置格式正确

  • 确保maxclients 50000行没有被注释（行首无#），没有多余空格或拼写错误。
  • 进入容器查看配置文件内容：cat /usr/local/etc/redis/redis.conf | grep maxclients，确认配置行存在且未被注释。

• 验证容器启动日志
  查看容器启动日志：docker logs <容器ID>，搜索"Configuration loaded"或"maxclients"关键字，确认Redis启动时是否成功加载了指定的配置文件。如果日志显示加载默认配置，检查COPY命令是否将文件放到了正确路径。

• 重新构建/重启容器
  修改配置后，需要重新构建镜像并启动容器：

  docker build -t custom-redis .
  docker run -d custom-redis
  

  再次用redis-cli info clients验证maxclients值是否生效。

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