Docker容器环境变量异常：mongo-express无法读取共享变量

常见原因及修复方案 #

1. 共享变量作用域未覆盖到Mongo-Express服务 #

如果共享变量仅定义在Mongo服务的environment块中，或使用扩展字段但未在Mongo-Express中显式引用，就会出现只有Mongo能拿到变量的情况。

正确的共享变量配置示例：

# 定义共享环境变量的扩展字段
x-shared-mongo-env: &shared-mongo-env
  MONGO_HOST: mongo
  MONGO_PORT: 27017

services:
  mongo:
    image: mongo:latest
    environment:
      <<: *shared-mongo-env  # 继承共享变量
      MONGO_INITDB_ROOT_USERNAME: admin
      MONGO_INITDB_ROOT_PASSWORD: admin123
    volumes:
      - mongo-data:/data/db

  mongo-express:
    image: mongo-express:latest
    environment:
      <<: *shared-mongo-env  # 必须在此显式继承共享变量
      ME_CONFIG_MONGODB_URL: mongodb://admin:admin123@${MONGO_HOST}:${MONGO_PORT}/admin?authSource=admin
      ME_CONFIG_BASICAUTH_USERNAME: me-admin
      ME_CONFIG_BASICAUTH_PASSWORD: me-admin123
    depends_on:
      - mongo
    ports:
      - "8081:8081"

volumes:
  mongo-data:

关键：共享变量需要通过<<: *shared-mongo-env语法，注入到Mongo-Express的environment块中，否则变量仅存在于Mongo服务的环境上下文里。

2. 变量引用拼写或语法错误 #

Docker-Compose的变量引用大小写敏感，检查ME_CONFIG_MONGODB_URL中的变量名是否与共享变量完全一致（比如别把MONGO_PORT写成Mongo_Port）。同时确保变量引用格式正确：使用${变量名}，不要遗漏美元符号或大括号。

3. .env文件加载异常（若使用.env） #

如果共享变量定义在.env文件中，需确保Docker-Compose能正确读取：

• 执行docker-compose命令时，当前工作目录是.env文件所在目录；
• 若.env不在默认路径，需用--env-file参数指定，例如：

  docker-compose -f docker-compose.prod.yml --env-file ./config/.env up --build -d
  

• 注意：系统环境变量会优先覆盖.env文件中的同名变量，若存在冲突需调整。

4. 验证变量是否真的注入容器 #

执行以下命令查看Mongo-Express容器的环境变量，确认共享变量是否存在：

docker exec -it <你的mongo-express容器名称> env

如果输出中找不到MONGO_HOST或MONGO_PORT，说明变量未成功注入，回到前面的步骤检查配置；如果能找到，那可能是Mongo服务未就绪导致的连接失败（这种情况有时会被误报为变量未设置）。

额外提示 #

depends_on仅保证容器启动顺序，不保证Mongo服务完全就绪。如果是Mongo未就绪导致的连接问题，可以给Mongo配置健康检查，让Docker-Compose等待服务就绪后再启动Mongo-Express：

services:
  mongo:
    image: mongo:latest
    # ... 其他配置
    healthcheck:
      test: ["CMD", "mongosh", "--eval", "db.adminCommand('ping')"]
      interval: 5s
      timeout: 5s
      retries: 5

  mongo-express:
    # ... 其他配置
    depends_on:
      mongo:
        condition: service_healthy

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