使用docker compose --env-file未加载production.env变量的问题

我尝试用命令 docker compose --env-file ./production.env up --build 构建Docker项目，想把环境变量放在Dockerfile之外的独立文件里，所以用了--env-file参数。

执行命令后Docker没报错，容器也创建成功了，但我的项目检测到环境变量缺失直接退出了。

我运行的是Node.js项目，文件结构如下：

• docker-compose.yml
• Dockerfile
• production.env
• ...其他文件（src文件夹等）

Dockerfile内容：

FROM node:16-alpine as development

WORKDIR /usr/src/app

COPY package*.json .

RUN npm install

COPY . .

RUN npm run build

FROM node:16-alpine as production

WORKDIR /usr/src/app

COPY package*.json .

RUN npm ci --only=production

COPY --from=development /usr/src/app/dist ./dist

CMD ["node", "dist/index.js"]

docker-compose.yml内容：

version: "3.4"

services:
  api:
    build:
      context: .
      target: production

    ports:
      - 8888:8888

Node.js项目运行需要的环境变量存在production.env里，示例内容：

DB_URI=https://urihere.net
PASSWORD_KEY=somepw

你用的--env-file参数是给Docker Compose本身用的，作用是替换docker-compose.yml文件里的占位符变量（比如${DB_URI}），不会自动把这些变量注入到容器内部。所以容器启动时，你的Node.js项目根本拿不到这些环境变量，自然会因为缺失变量退出。

方法一：在docker-compose.yml中配置env_file #

直接在api服务里添加env_file字段，指定你的环境变量文件，这样Compose会自动把文件里的变量注入到容器中：

version: "3.4"

services:
  api:
    build:
      context: .
      target: production
    env_file: ./production.env  # 新增这一行
    ports:
      - 8888:8888

修改后重新运行docker compose up --build即可。

方法二：运行时通过-e参数传递变量 #

如果不想修改compose文件，可以在运行命令时用-e逐个指定变量，但变量多的话比较麻烦：

docker compose up --build -e DB_URI=https://urihere.net -e PASSWORD_KEY=somepw

验证方法 #

容器启动后，你可以进入容器查看环境变量是否生效：

docker exec -it <容器ID或名称> printenv

如果能看到DB_URI和PASSWORD_KEY，说明变量已经正确注入。

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