使用GitHub Actions构建并推送Docker镜像至DockerHub时遭遇‘invalid reference format’错误求助

我帮你排查了下，这个错误主要有两个核心问题，咱们一个个说清楚：

• 未定义关键环境变量：你最后一步的docker push ${{ env.IMAGE }}:${{ env.GIT_SHA }}命令里用了IMAGE和GIT_SHA两个变量，但整个Workflow里完全没设置过它们的值。这就导致命令变成了docker push :，完全不符合镜像引用的标准格式（正确格式应为仓库名/镜像名:标签），自然会报invalid reference format。

• Docker构建推送Action配置有误：你给docker/build-push-action设置了load: true（仅把镜像加载到本地Docker），但没开启push: true来直接推送到DockerHub；同时当前的tags只指定了shirzadi/ehsan:latest，没有包含基于提交SHA的标签，和最后一步的推送命令完全不匹配。

下面是修改后的完整Workflow配置，我会标注每个修改点：

name: ci
on:
  push:
    branches:
      - 'master'
jobs:
  docker:
    runs-on: ubuntu-latest
    env:
      IMAGE: shirzadi/ehsan  # 定义镜像名环境变量，统一管理
      GIT_SHA: ${{ github.sha }}  # 通过GitHub上下文获取当前提交的唯一SHA值
    steps:
      - name: Checkout
        uses: actions/checkout@v2
      - name: Set up QEMU
        uses: docker/setup-qemu-action@v1
      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v1
      - name: Login to DockerHub
        uses: docker/login-action@v1
        with:
          username: ${{ secrets.DOCKERHUB_USERNAME }}
          password: ${{ secrets.DOCKERHUB_PASSWORD }}
      - name: Build and push
        uses: docker/build-push-action@v2
        with:
          context: .
          push: true  # 替换load为push，让Action直接推送镜像到DockerHub
          tags: |
            ${{ env.IMAGE }}:latest
            ${{ env.IMAGE }}:${{ env.GIT_SHA }}  # 同时构建并推送带SHA标签的镜像

关键修改说明： #

1. 新增环境变量定义：在job级别添加env块，统一管理镜像名和提交SHA标签，避免变量未定义的问题。
2. 调整构建推送模式：把load: true改成push: true，利用docker/build-push-action本身的推送能力，不需要单独执行docker push命令，简化流程同时避免本地镜像操作的潜在问题。
3. 补充多标签配置：在tags里同时添加latest和SHA标签，这样每次推送master分支时，会同时推送两个版本的镜像——既保留了"最新版"的标识，也能通过SHA精准定位到特定提交的镜像。

这样修改后，Workflow就能正常构建并推送镜像到DockerHub，不会再出现格式错误了。

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