Docker Compose运行报错及文件与安装版本匹配疑问求助

问题现象 #

运行AI生成的docker-compose.yml和global.env时，出现两类问题：

1. 大量环境变量未设置警告，如The "GLOBAL_PASSWORD" variable is not set. Defaulting to a blank string.
2. 配置验证错误：(root) Additional property env_file is not allowed
3. 疑惑点：Docker Compose安装版本为2.18.1，文件指定版本为3.8，二者是否必须一致？

错误原因 #

1. env_file配置位置错误：Docker Compose的根级别配置中不支持env_file字段，该字段只能定义在具体的services条目下，或者通过命令行参数全局指定。根级别放置env_file会导致配置验证失败，同时环境变量无法被加载。
2. 环境变量未加载：由于env_file位置错误，global.env中的变量无法被注入到服务容器，因此出现变量未设置的警告。

解决步骤 #

方法一：将env_file移至服务级别（推荐） #

修改docker-compose.yml，将env_file字段添加到每个需要使用环境变量的服务配置中：

version: "3.8"

services:
  db_migration:
    image: postgres:latest
    restart: on-failure
    env_file:
      - ./env/global.env
    environment:
      POSTGRES_PASSWORD: ${GLOBAL_PASSWORD}
      POSTGRES_USER: ${GLOBAL_USER}
      POSTGRES_DB: ${GLOBAL_DB}
    ports:
      - "5000:5000"
    volumes:
      - "./db/:/tmp/db"
    command:
      - /bin/bash
      - -e
      - -c
      - >
        sleep 4 && cd /tmp &&
        psql -h localhost -U postgres -f db/schema.sql -f db/data.sql

  postgraphile:
    image: graphile/postgraphile:latest
    restart: unless-stopped
    depends_on:
      - db_migration
    env_file:
      - ./env/global.env
    environment:
      PGPASSWORD: ${GLOBAL_PASSWORD}
      PGUSER: ${GLOBAL_USER}
      PGDATABASE: ${GLOBAL_DB}
      PGHOST: ${GLOBAL_HOST}
    command:
      [
        "--enhance-graphiql",
        "--allow-explain",
        "--port",
        "5000",
        "--schema",
        "public",
        "--watch",
      ]

方法二：通过命令行指定全局环境文件 #

无需修改docker-compose.yml，运行Compose时添加--env-file参数加载全局环境变量：

docker compose --env-file ./env/global.env up

Compose文件版本与安装版本的关系 #

• Compose文件版本（如3.8）是功能规范版本，定义了配置文件支持的语法和特性；Compose安装版本（如2.18.1）是CLI工具的版本。
• 高版本的CLI工具完全兼容低版本的文件规范，只要CLI版本不低于文件指定的规范版本，即可正常运行，无需版本完全一致。
• 不存在3.18的Compose文件版本，3.x系列最高版本为3.9；后续Compose文件版本改为与CLI版本对齐，但实际使用中3.8已足够覆盖绝大多数常用功能。

内容的提问来源于stack exchange，提问作者Ουιλιαμ Αρκευα