Docker Compose环境变量传递异常及容器预启动操作最佳实践咨询

一、环境变量无法传递的直接原因 #

你的docker-compose.yml里环境变量的写法存在语法错误：

environment:
- REDIS_HOST = redis  # 等号前后带空格，解析错误
- DB_NAME=mydbname
- DB_USER=myusername
- ES_URL = elasticsearch  # 等号前后带空格，解析错误

YAML 中环境变量的正确格式是KEY=VALUE，等号前后不能有空格。带空格的写法会被解析成包含空格的变量名（比如REDIS_HOST ），导致 entrypoint 脚本无法读取到正确的变量。

修正后的 environment 配置：

environment:
- REDIS_HOST=redis
- DB_NAME=mydbname
- DB_USER=myusername
- ES_URL=elasticsearch

二、服务就绪的隐性问题 #

即使环境变量传对了，你大概率会遇到另一个问题：depends_on仅保证容器的启动顺序，不保证容器内的服务（PostgreSQL、Elasticsearch）已经完全就绪。entrypoint 脚本启动时可能会因为连接不上未初始化完成的服务而失败。

解决方法是在 entrypoint.sh 中加入服务健康检查逻辑，示例如下：

#!/bin/sh

# 等待PostgreSQL就绪
until pg_isready -h "db" -U "$DB_USER" -d "$DB_NAME"; do
  echo "等待PostgreSQL启动..."
  sleep 2
done

# 等待Redis就绪
until redis-cli -h "$REDIS_HOST" ping; do
  echo "等待Redis启动..."
  sleep 2
done

# 等待Elasticsearch就绪
until curl -s "$ES_URL:9200/_cluster/health?wait_for_status=yellow&timeout=1s"; do
  echo "等待Elasticsearch启动..."
  sleep 2
done

# 执行数据同步逻辑
echo "开始数据同步..."
# 替换为你的实际同步命令，比如 python sync_data.py

# 启动Web应用（兼容CMD参数）
exec "$@"

注意：需确保容器内已安装pg_isready（postgresql-client 包）、redis-cli、curl工具。

三、多服务容器化的最佳实践 #

1. 环境变量规范：始终使用KEY=VALUE无空格格式传递环境变量，避免 YAML 解析异常。
2. ENTRYPOINT 与 CMD 配合：用 ENTRYPOINT 做初始化操作（同步、服务等待），用 CMD 定义应用启动命令，最后在 entrypoint 脚本中用exec "$@"执行 CMD 内容，保证应用进程是容器的 PID 1，便于信号处理。Dockerfile 示例：

ENTRYPOINT ["./entrypoint.sh"]
CMD ["gunicorn", "app:app", "--bind", "0.0.0.0:8000"]

3. 删除冗余配置：Docker Compose v3 版本中，默认会为所有服务创建共享网络，服务名可直接作为 DNS 解析，links配置完全冗余，可以删除。
4. 区分 expose 与 ports：expose仅声明容器内部端口，不需要做端口映射，正确写法是expose: 6379而非expose: 6379:6379；端口映射统一用ports字段。修正后的 redis、elasticsearch 配置：

redis:
  image: 'redis:alpine'
  expose: 
     - 6379

elasticsearch:
  image: 'docker.elastic.co/elasticsearch/elasticsearch:7.13.1'
  environment: 
    - node.name=node-1
    - cluster.initial_master_nodes=node-1
  expose:
    - 9200

内容的提问来源于stack exchange，提问作者Lucifer N.