Docker Compose environment配置环境变量失效问题原因及解决方法

问题原因 #

核心问题是你的compose.yaml中environment字段误用了变量插值语法：
你大概率写成了类似这样的配置：

environment:
  WORKER_NUMBER: ${WORKER_NUMBER}

这种写法会让Docker Compose尝试从系统环境变量或.env文件中读取WORKER_NUMBER的值，但你既没有创建.env文件，也未在当前终端环境中设置该变量，因此Compose会抛出警告并将变量值默认设为空字符串。

另外，你的Docker Engine版本（19.03.15）属于较旧版本，虽然Docker Compose v2.27.0理论上兼容，但部分语法解析的细节差异也可能放大这类写法错误的影响，但这并非主要原因。

正确设置环境变量的方法 #

通过environment字段设置环境变量有两种常用正确写法，根据你的需求选择：

1. 直接硬编码赋值（最匹配你的场景） #

在compose.yaml中直接指定变量值，无需引用外部变量：

services:
  service_a:
    # 你的其他服务配置（如image、ports等）
    environment:
      WORKER_NUMBER: 1

这种写法会直接将WORKER_NUMBER=1注入到容器的环境变量中，完全不依赖外部文件或系统环境。

2. 从外部环境传入（可选） #

如果需要灵活调整变量值而非硬编码：

• 通过终端环境变量传入：先在终端执行export WORKER_NUMBER=1，再在compose.yaml中保留变量插值写法：

  environment:
    WORKER_NUMBER: ${WORKER_NUMBER}
  

• 通过.env文件传入：在工作目录创建.env文件，写入WORKER_NUMBER=1，compose.yaml同样使用插值写法即可。

验证方法 #

启动服务后，执行以下命令验证变量是否生效：

docker compose exec service_a echo $WORKER_NUMBER

正常情况下会输出1，说明环境变量已正确设置。

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