基于redis:6.0-alpine扩展Docker镜像拷贝配置文件未生效问题求助

最高发原因：/data目录被挂载卷覆盖 #

• 官方redis:6.0-alpine的默认工作目录为/data，你写的WORKDIR .实际是继承这个默认路径，因此COPY的目标路径./config/redis.conf实际对应容器内的/data/config/redis.conf。
• 多数人启动Redis容器时，会沿用官方配置将宿主机目录挂载到/data存储持久化文件，这个操作会完全覆盖容器内/data目录的所有原有内容，包括你提前COPY的配置文件。
• 排查命令：执行docker inspect 你的容器名，查看Mounts字段，确认是否有宿主机挂载路径指向容器内/data。
• 解决方法：
  • 直接将配置文件COPY到非/data的路径，推荐使用Redis官方默认配置路径/etc/redis/redis.conf
  • 或显式指定非/data的工作目录，避免被挂载覆盖

构建阶段COPY未实际生效 #

如果上述排查没有发现挂载问题，说明COPY步骤本身就没有将文件写入镜像：

• 确认你启动容器用的是最新构建的镜像，而非之前遗留的旧镜像，修改Dockerfile后需要重新执行docker build命令生成新镜像，再启动容器。
• 确认构建上下文是否正确：COPY的源路径redis.master.conf是相对于构建上下文根目录的，不是相对于Dockerfile所在目录。正确的操作流程为：将Dockerfile与redis.master.conf放在同一目录下，进入该目录执行构建命令docker build -t my-redis:6.0-alpine .（末尾的点为上下文标识）
• 跳过容器启动，直接验证镜像内的文件是否存在：执行docker run --rm my-redis:6.0-alpine ls -la 对应路径，如果执行后无报错且能看到文件，说明COPY正常，问题仍为启动时的挂载覆盖；如果提示文件不存在，说明COPY未生效，重新检查构建上下文与文件权限。
• 补充说明：你的Dockerfile中WORKDIR .无实际作用，等同于不修改默认工作目录，建议直接删除，避免混淆路径判断。

路径查找错误 #

• 你当前的写法实际将文件放到了/data/config/redis.conf，而非Redis默认的/etc/redis/redis.conf，如果是按照默认路径查找自然无法找到。
• 如果需要自定义路径，需在启动命令中显式指定配置文件路径，或直接使用绝对路径写入到默认配置目录。

WSL2环境特殊排查项 #

如果以上步骤均正常，再排查WSL2的文件读取问题：

• 确认redis.master.conf有可读权限，执行ls -l redis.master.conf确认权限配置正常
• 如果文件放在Windows挂载路径（即/mnt/c/xxx类路径下），尝试将文件复制到WSL2原生文件系统（如~/xxx）后重新构建，避免WSL2的文件同步驱动异常导致文件未被正确读取。

FROM redis:6.0-alpine
# 直接将配置写入官方默认路径，避免被/data挂载覆盖
COPY redis.master.conf /etc/redis/redis.conf
# 可选：指定启动时加载该配置文件
CMD ["redis-server", "/etc/redis/redis.conf"]

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