Dockerfile未正确复制文件？Redis容器启动报文件不存在错误

核心错误：CMD指令格式误用 #

你当前的CMD ["redis-server redis.conf"]采用了JSON数组格式，Docker会把整个字符串当作单个命令执行——相当于让Redis去寻找名为redis-server redis.conf的配置文件，这直接导致了报错。正确写法要把命令和参数分开：

CMD ["redis-server", "./redis.conf"]

或者使用shell格式：

CMD redis-server ./redis.conf

其他关键问题与修正 #

1. .env变量无法在构建阶段读取 #

Docker构建镜像时不会自动加载.env文件，所以RUN envsubst阶段根本获取不到里面的变量。需要在构建时通过--env-file参数主动传递：

docker build --env-file .env -t redis-test .

2. 替换后的配置文件未被使用 #

你通过envsubst < redis.conf > redisconf生成了变量替换后的配置文件，但启动时仍在使用未处理的原redis.conf，应该直接覆盖原文件：

RUN envsubst < redis.conf > ./redis.conf

3. EXPOSE指令的变量需构建时传递 #

EXPOSE $REDIS_PORT中的变量同样需要通过--env-file传递，否则会暴露空端口，没有实际作用。

4. 配置文件路径匹配问题 #

官方Redis镜像默认工作目录是/data，你COPY的redis.conf会放在/data/redis.conf，启动命令里的路径要与之对应。

修正后的完整Dockerfile #

FROM redis:latest

# 安装依赖并清理缓存，减少镜像体积
RUN apt-get update && apt-get -y install gettext && rm -rf /var/lib/apt/lists/*

# 复制配置模板到镜像工作目录
COPY redis.conf ./

# 替换模板中的环境变量（构建时需传递.env变量）
RUN envsubst < redis.conf > ./redis.conf

# 暴露配置的端口（构建时需传递REDIS_PORT变量）
EXPOSE $REDIS_PORT

# 正确启动Redis，使用替换后的配置文件
CMD ["redis-server", "./redis.conf"]

构建与运行命令 #

构建镜像 #

docker build --env-file .env -t redis-test .

运行容器 #

# 替换${REDIS_PORT}为你.env中的实际端口，或用以下命令自动读取
env $(cat .env | xargs) docker run -dp 6379:${REDIS_PORT} redis-test

额外优化建议 #

• 将配置文件放到Redis官方推荐路径/usr/local/etc/redis/redis.conf，启动命令可简化为redis-server（无需指定路径）
• 若需多环境复用，可通过构建参数区分不同环境的配置变量

内容的提问来源于stack exchange，提问作者Miha Šušteršič