Docker Compose中MYSQL_USER/MYSQL_PASSWORD环境变量不生效原因咨询

我有一个仅用于测试的docker-compose.override.yml文件，内容如下：

---
version: "3.8"
services:
  db:
    image: "dolthub/dolt-sql-server"
    volumes:
      - "nautobot_data:/var/lib/dolt"
    env_file:
      - "local.env"
    command: ["-u ${MYSQL_USER}", "-p ${MYSQL_PASSWORD}"]
    restart: "unless-stopped"
    ports:
      - "3306:3306"
volumes:
  nautobot_data:

local.env文件内容如下：

MYSQL_USER=nautobot
MYSQL_PASSWORD=<removed for privacy>

执行docker compose -f docker-compose.override.yml config后，输出中command部分为['-u ', '-p ']；执行docker compose -f docker-compose.override.yml up时出现警告提示"MYSQL_USER"和"MYSQL_PASSWORD"变量未设置；执行docker ps --no-trunc可见容器命令中的参数为空。我也曾尝试使用单引号写法command: ['-u ${MYSQL_USER}', '-p ${MYSQL_PASSWORD}']，问题依旧。请问为何MYSQL_USER和MYSQL_PASSWORD变量无法生效？

核心原因 #

Docker Compose处理数组格式的command时，不会对元素中的环境变量做插值解析——数组格式的命令会被直接作为参数传递给容器进程，跳过了Compose层面的变量替换步骤。而env_file定义的变量是在容器内部生效的，Compose解析command数组时无法读取到这些变量。即便用单引号包裹数组元素，${VAR}依然不会被解析，因为数组模式下Compose默认不做变量替换。

解决方法 #

方法1：改用Shell格式的command #

将command写成字符串形式，让容器通过Shell解析环境变量：

command: "-u ${MYSQL_USER} -p ${MYSQL_PASSWORD}"

或者明确指定Shell执行：

command: ["sh", "-c", "-u ${MYSQL_USER} -p ${MYSQL_PASSWORD}"]

这种方式下，Shell会在容器内部读取env_file加载的变量，完成替换后再执行命令。

方法2：用Compose的environment传递变量并启用插值 #

若坚持使用数组格式的command，可先通过Compose的environment声明变量，同时确保变量能被Compose读取（比如主机环境中存在变量，或项目根目录有.env文件）：

1. 确保主机环境存在MYSQL_USER和MYSQL_PASSWORD，或在项目根目录创建.env文件（内容与local.env一致）；
2. 修改docker-compose.override.yml：

services:
  db:
    # 保留原有其他配置
    env_file:
      - "local.env"
    environment:
      - MYSQL_USER=${MYSQL_USER}
      - MYSQL_PASSWORD=${MYSQL_PASSWORD}
    command: ["-u", "${MYSQL_USER}", "-p", "${MYSQL_PASSWORD}"]

注意要将每个参数拆分为单独的数组元素（比如"-u"和"${MYSQL_USER}"分开），这样Compose才能正确替换变量后传递给容器。

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