Docker Compose无法识别.env.local配置container_name问题排查

疑问解答 #

疑问1：Docker Compose是否支持加载.env以外的文件？ #

支持，但要区分Compose配置解析用变量和容器内部环境变量的加载逻辑：

• env_file字段仅负责将变量注入到容器内部环境中，不会影响Compose对配置文件本身的解析（比如container_name、ports这类配置字段里的变量引用）。
• 要让Compose在解析配置时加载自定义环境变量文件，需要通过--env-file命令行参数，或者设置COMPOSE_ENV_FILE环境变量来指定路径。

疑问2：Docker Compose默认自动加载.env是否为默认行为？ #

是默认行为。Docker Compose启动时，会自动读取当前工作目录下的.env文件，将其中的变量注入到Compose的配置解析上下文，让你可以在docker-compose.yml的配置字段中直接用${变量名}引用。

问题原因与解决方案 #

问题根因 #

你的配置中，env_file只把APP_NAME传给了容器内部，但container_name属于Compose配置层面的字段，需要Compose在解析配置时就能读取到APP_NAME变量。当前Compose解析时没读到该变量，导致${APP_NAME}被替换为空，容器名变成-database，违反了容器名的命名规则（只能包含字母、数字、下划线、点、连字符，且不能以非字母数字开头），所以报错。

解决方法 #

方法1：启动时指定环境变量文件

执行Compose命令时，用--env-file参数指定你的自定义.env文件路径：

docker-compose --env-file ./docker.config/.env up -d

这样Compose在解析docker-compose.yml时，会加载这个文件里的变量，container_name就能正常替换为MY-APP-wordpress和MY-APP-database。

方法2：设置环境变量默认加载文件

通过设置COMPOSE_ENV_FILE环境变量，让Compose默认加载你的自定义文件：

• Linux/macOS终端：

  export COMPOSE_ENV_FILE=./docker.config/.env
  

• Windows命令提示符：

  set COMPOSE_ENV_FILE=./docker.config/.env
  

设置后，后续执行docker-compose up等命令时，会自动加载指定的.env文件，无需每次加参数。

验证方法

执行docker-compose --env-file ./docker.config/.env config，就能看到container_name被正确替换：

wpdb:
    container_name: MY-APP-database
    environment:
      APP_NAME: MY-APP
      # 其他环境变量...

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