Docker镜像部署时.env文件缺失致容器启动失败的问题排查

核心原因：.env未被注入容器 #

你的docker-compose.yml中env_file是本地宿主机的文件，仅在本地通过docker-compose启动时用来注入环境变量，但这个文件并没有被打包到镜像里（Dockerfile里没有COPY .env的步骤）。推送到私有仓库的镜像不包含.env，虚拟机上用docker run启动时，既没有挂载.env文件，也没有通过其他方式传递环境变量，导致entrypoint脚本因set -o nounset（未定义变量直接退出）触发STRATEGY_DB_NAME未绑定的报错。

要不要上传所有项目文件到虚拟机？ #

不需要。镜像已经通过Dockerfile打包了运行所需的代码、依赖、启动脚本等核心内容，除非你需要像本地那样实时同步代码修改到容器（依赖volumes挂载），否则无需上传整个项目。

解决方法（三种可选） #

方法1：虚拟机创建.env并通过--env-file启动 #

• 在虚拟机任意目录创建strategy/.env（比如/opt/strategy/.env），复制本地.env的内容进去
• 启动命令修改为：

  docker run -d --env-file /opt/strategy/.env -p 8004:8004 strategy
  

方法2：通过-e参数逐个传递环境变量 #

如果.env里变量不多，可以直接在启动命令里用-e指定每个变量：

docker run -d \
  -e STRATEGY_DB_NAME=你的数据库名 \
  -e STRATEGY_DB_USER=你的数据库用户 \
  -e STRATEGY_DB_PASSWORD=你的数据库密码 \
  -e STRATEGY_DB_HOST=你的数据库地址 \
  -e STRATEGY_DB_PORT=你的数据库端口 \
  -p 8004:8004 \
  strategy

方法3：用docker-compose在虚拟机启动（推荐，和本地流程一致） #

• 仅需把本地的docker-compose.yml和strategy/.env两个文件传到虚拟机（无需整个项目）
• 在文件所在目录执行：

  docker-compose up -d
  

  docker-compose会自动读取env_file配置加载环境变量，和本地启动逻辑完全一致。

重要提醒 #

绝对不要把.env文件通过Dockerfile打包到镜像里！.env包含数据库密码等敏感信息，镜像一旦泄露，敏感数据会直接暴露，违反安全规范。

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