Redis容器启动报错：requirepass参数数量异常排查求助

1. 修正命令行参数语法 #

硬编码密码时，docker-compose.yml里的command不要给密码加引号，正确写法：

command: redis-server --requirepass password

之前加引号会导致Redis解析异常；如果${REDIS_PASSWORD}为空，命令会变成redis-server --requirepass，缺少密码值直接触发参数错误。

2. 排查是否存在隐藏的redis.conf #

Redis镜像默认加载内置配置，但容器若挂载了本地卷或残留缓存，可能加载了其他配置文件：

• 查看容器实际执行的启动命令：

docker-compose ps redis

• 查看完整启动日志，确认命令是否被正确执行：

docker-compose logs redis

• 临时启动干净的同版本容器，查看默认配置路径：

docker run --rm redis:6.2.11 redis-cli config get dir

检查你的容器是否挂载了该路径的卷，导致加载旧配置。

3. 清理Docker缓存与残留资源 #

• 彻底删除Redis容器及关联卷，避免旧配置残留：

docker-compose down -v

重新启动容器：

docker-compose up redis

• 拉取干净的Redis镜像，避免镜像缓存问题：

docker rmi redis:6.2.11
docker pull redis:6.2.11

4. 环境变量与密码配置验证 #

• 如果需要密码，在env.txt中添加配置：

REDIS_PASSWORD=your_secure_password

• 如果不需要密码，直接删除docker-compose.yml中command里的--requirepass ${REDIS_PASSWORD}部分，让Redis以默认无密码模式启动。

5. 验证文档疏漏可能性 #

如果团队README未要求设置Redis密码，但docker-compose.yml里包含了密码配置，大概率是文档疏漏。可以先去掉--requirepass相关配置，测试容器能否正常启动，以此确认问题根源。

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