Docker Compose命令字段条件Shell展开报错及需求解决咨询

问题背景 #

需要容器启动时执行npm run test -g $GREP，核心需求：当环境变量GREP已设置时，传递-g参数和变量值；未设置时，仅执行npm run test。但运行GREP=upload docker compose up playwright时触发错误：

invalid interpolation format for services.playwright.command.[]: "${GREP:+-g}". You may need to escape any $ with another $

现有配置 #

Docker Compose的playwright服务配置 #

playwright:
  container_name: playwright
  image: playwright:latest
  build:
    context: ./e2e
    dockerfile: Dockerfile
  working_dir: /home/playwright
  command: ['test', '--', '${GREP:+-g}', '${GREP}']

Dockerfile内容 #

FROM mcr.microsoft.com/playwright:v1.25.0-focal
USER pwuser
WORKDIR /home/playwright
COPY package.json package-lock.json ./
RUN npm ci
COPY . ./
ENTRYPOINT ["npm", "run"]
CMD ["test"]

错误原因 #

Docker Compose会优先解析${...}格式的插值语法，但${GREP:+-g}是Shell的参数展开语法，Docker Compose无法识别，因此报错。

解决方案 #

方案1：改用Shell格式命令，让容器内Shell处理条件 #

将Docker Compose中的command从数组格式改为字符串格式，转义$让Docker Compose不解析，交给容器内的Shell处理逻辑：

playwright:
  # 其他配置不变
  command: sh -c 'npm run test -- ${GREP:+-g "$GREP"}'

• 当GREP存在时，Shell会展开为npm run test -- -g "upload"
• 当GREP不存在时，直接执行npm run test --（--不影响无参数的情况）

方案2：使用启动脚本（更易维护） #

在./e2e目录下创建start.sh脚本，封装参数逻辑：

#!/bin/sh
set -e

if [ -n "$GREP" ]; then
  npm run test -- -g "$GREP"
else
  npm run test
fi

给脚本添加执行权限：

chmod +x ./e2e/start.sh

修改Dockerfile，复制脚本并设置为入口：

FROM mcr.microsoft.com/playwright:v1.25.0-focal
USER pwuser
WORKDIR /home/playwright
COPY package.json package-lock.json ./
RUN npm ci
COPY . ./
COPY start.sh ./
RUN chmod +x start.sh
ENTRYPOINT ["./start.sh"]

最后简化Docker Compose配置（无需再写复杂command）：

playwright:
  container_name: playwright
  image: playwright:latest
  build:
    context: ./e2e
    dockerfile: Dockerfile
  working_dir: /home/playwright
  environment:
    - GREP=${GREP}

方案3：Docker Compose条件插值（适用于3.7+版本） #

利用Docker Compose的条件插值语法，仅在GREP存在时添加参数：

playwright:
  # 其他配置不变
  command:
    - test
    - --
    ${GREP:+- -g}
    ${GREP:+- $GREP}

注意：这种写法如果GREP未设置，会避免传递空参数，但可读性不如前两种方案。

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