GitHub Workflow构建Docker镜像失败：多build参数传递问题

错误原因分析 #

报错"docker buildx build" requires exactly 1 argument的核心原因：

• 多行JSON格式的GCP密钥直接嵌入命令时，换行符会被bash解析为命令分隔符，导致Docker命令被截断，参数不完整。
• 即使移除密钥参数，命令行的换行和引号处理仍存在语法问题，导致Docker无法识别完整的构建路径参数。

修复方案 #

1. 优化GitHub Workflow构建步骤 #

修改deploy.yml中的Build and push Docker image步骤，通过环境变量传递秘密，避免直接在命令中嵌入多行内容：

- name: Build and push Docker image
  env:
    MGL_BASE_URL: ${{ vars.MGL_BASE_URL }}
    MGL_LOGIN_URL: ${{ vars.MGL_LOGIN_URL }}
    FIREBASE_DATABASE_URL: ${{ vars.FIREBASE_DATABASE_URL }}
    GCP_SA_KEY_PRF_SELECTOR: ${{ secrets.GCP_SA_KEY_PRF_SELECTOR }}
    GCP_PROJECT_ID: ${{ vars.PRF_EXTRACTOR_GCP_PROJECT_ID }}
  run: |
    docker build \
      --build-arg MGL_BASE_URL="$MGL_BASE_URL" \
      --build-arg MGL_LOGIN_URL="$MGL_LOGIN_URL" \
      --build-arg FIREBASE_DATABASE_URL="$FIREBASE_DATABASE_URL" \
      --build-arg GCP_SA_KEY_PRF_SELECTOR="$GCP_SA_KEY_PRF_SELECTOR" \
      -t gcr.io/$GCP_PROJECT_ID/profile-extractor \
      .
    docker push gcr.io/$GCP_PROJECT_ID/profile-extractor

关键调整点：

• 将所有变量存入环境变量，通过$VAR_NAME引用，避免GitHub模板语法与bash解析冲突。
• 调整参数顺序，将构建路径.放在最后，确保Docker识别唯一的路径参数。
• 用双引号包裹环境变量引用，保证多行内容被作为单个参数传递。

2. （可选）Base64编码处理多行秘密 #

若仍存在多行内容解析问题，可对密钥进行Base64编码后存储：

本地编码密钥

执行命令将JSON密钥转为Base64格式：

base64 -w 0 your-service-account-key.json > encoded-key.txt

将encoded-key.txt内容存入GitHub SecretGCP_SA_KEY_PRF_SELECTOR_BASE64。

Workflow中解码使用

- name: Build and push Docker image
  env:
    # ...其他环境变量
    GCP_SA_KEY_PRF_SELECTOR: ${{ secrets.GCP_SA_KEY_PRF_SELECTOR_BASE64 }}
  run: |
    SA_KEY=$(echo "$GCP_SA_KEY_PRF_SELECTOR" | base64 -d)
    docker build \
      --build-arg MGL_BASE_URL="$MGL_BASE_URL" \
      --build-arg MGL_LOGIN_URL="$MGL_LOGIN_URL" \
      --build-arg FIREBASE_DATABASE_URL="$FIREBASE_DATABASE_URL" \
      --build-arg GCP_SA_KEY_PRF_SELECTOR="$SA_KEY" \
      -t gcr.io/$GCP_PROJECT_ID/profile-extractor \
      .
    docker push gcr.io/$GCP_PROJECT_ID/profile-extractor

3. Dockerfile验证 #

你的Dockerfile配置无需修改，ARG与ENV的映射能确保构建参数被正确转为容器环境变量，后续代码可通过os.getenv()正常调用。

测试验证 #

提交修改后的Workflow到main分支，触发构建：

• 检查GitHub Actions日志，确认Docker命令完整执行，无参数错误。
• 验证Cloud Run服务部署成功，应用可正常读取环境变量。

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