Docker Compose无法从.env.production加载环境变量的问题

问题原因 #

Docker Compose在解析配置文件的阶段（比如处理ports、command中的变量替换），只会读取系统环境变量、当前目录下的.env文件，或是通过--env-file参数指定的文件。而你在services.web下配置的env_file，作用是给容器内部加载环境变量，不会影响Compose本身对配置文件的解析逻辑。

因此直接执行docker-compose -f docker-compose.production.yml up --build时，Compose解析${PORT}这类变量找不到对应值，就会抛出警告，最终因ports配置出现空值报错。

可行解决方案 #

1. 运行命令时指定--env-file

这是你已经验证有效的方式，直接让Compose在解析阶段加载目标环境变量文件：

docker-compose -f docker-compose.production.yml --env-file .env.production up --build

2. 重命名环境变量文件为.env

Docker Compose默认会自动加载当前目录下的.env文件，只需把.env.production改名为.env，就能直接运行原命令：

mv .env.production .env
docker-compose -f docker-compose.production.yml up --build

3. 给Compose配置添加全局env_file

在docker-compose.production.yml顶部添加全局env_file字段，让Compose解析阶段加载指定文件，同时保留容器内部的环境变量配置：

env_file:
  - .env.production
services:
  web:
    build: .
    command: uvicorn main:app --host ${HOST} --port ${PORT}
    ports:
      - "${PORT}:${PORT}"
    env_file:
      - .env.production
    environment:
      - APP_NAME=${APP_NAME}
      - ENVIRONMENT=${ENVIRONMENT}
      - HOST=${HOST}
      - PORT=${PORT}
      - DEBUG=${DEBUG}

修改后直接运行原命令即可：

docker-compose -f docker-compose.production.yml up --build

额外优化提示 #

你配置的environment字段其实可以简化——因为env_file已经会把.env.production中的变量注入容器内部，除非需要覆盖特定变量，否则完全可以删除environment部分，减少冗余配置。

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