Docker Compose构建阶段与Run命令变量替换失效问题

我来帮你排查Docker Compose变量替换失效的问题，结合你的配置，这里有几个常见的原因和对应的解决办法：

1. 先确认环境变量是否正确加载 #

变量替换失效最常见的原因是环境变量根本没被Docker Compose读取到，你可以通过以下两种方式确保变量能被加载：

• 终端临时导出变量：在运行docker-compose up前，先在终端执行：

  export KIBANA_VERSION=7.17.0
  export ELASTICSEARCH_INIT_TIMEOUT=30
  export KIBANA_HTTP_PORT=5601
  

• 使用.env文件：在docker-compose.yml的同级目录创建.env文件，内容如下（注意不要加多余空格或引号）：

  KIBANA_VERSION=7.17.0
  ELASTICSEARCH_INIT_TIMEOUT=30
  KIBANA_HTTP_PORT=5601
  

  Docker Compose会自动加载这个文件里的变量，无需额外配置。

2. 构建阶段（build args）变量失效的修复 #

你的构建参数里写了"${KIBANA_VERSION}"，这里的双引号可以去掉（不影响，但没必要），更关键的是：必须在Kibana的Dockerfile里声明这个构建参数，否则参数无法传递到构建流程中。

在services/kibana/Dockerfile里添加：

ARG KIBANA_VERSION
# 举个例子：用该版本下载安装Kibana
RUN curl -O https://artifacts.elastic.co/downloads/kibana/kibana-${KIBANA_VERSION}-linux-x86_64.tar.gz

没有ARG KIBANA_VERSION这一行，Docker会忽略你在docker-compose.yml里传递的构建参数。

3. Entrypoint里的变量替换问题 #

你的entrypoint用了>符号的多行写法，默认会通过sh -c执行，但变量替换可能因为shell解析规则失效，这里有两种修复方式：

• 改用数组形式的entrypoint：这种方式下Docker Compose会直接替换变量，无需依赖shell解析：

  entrypoint:
    - /scripts/wait-for-it.sh
    - elasticsearch:9200
    - -s
    - --timeout=${ELASTICSEARCH_INIT_TIMEOUT}
    - --
    - /usr/local/bin/kibana-docker
  

• 保留shell形式，但把变量注入容器环境：如果坚持用原写法，需要把ELASTICSEARCH_INIT_TIMEOUT加入容器的环境变量，让shell能读取到：

  environment:
    ELASTICSEARCH_URL: http://elasticsearch:9200
    ELASTICSEARCH_INIT_TIMEOUT: ${ELASTICSEARCH_INIT_TIMEOUT}
  entrypoint: >
    sh -c '/scripts/wait-for-it.sh elasticsearch:9200 -s --timeout=${ELASTICSEARCH_INIT_TIMEOUT} -- /usr/local/bin/kibana-docker'
  

4. 验证变量是否被正确替换 #

不管是哪个环节的变量，都可以用docker-compose config命令验证替换结果：

docker-compose config

这个命令会输出Docker Compose解析后的完整配置，你可以直接查看Kibana服务的build args、entrypoint、ports部分，确认变量是否被正确替换成了实际值。

额外注意事项 #

• 如果是Windows终端，环境变量的设置方式不同：CMD用set KIBANA_VERSION=7.17.0，PowerShell用$env:KIBANA_VERSION="7.17.0"。
• 不要在.env文件的变量值里加引号，比如KIBANA_VERSION="7.17.0"会导致变量值包含引号，引发异常。

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