GitHub Action执行成功却无法推送镜像至Docker Hub求助

核心原因 #

你的GitHub Workflow执行成功但镜像未出现在Docker Hub，最关键的问题是**docker/build-push-action未启用推送功能**。该Action的v4版本默认push参数为false，只会完成镜像构建，不会推送到远程仓库——这就是为什么手动推送正常，但自动化流程没结果的原因。

修复步骤 #

修改Build and push image步骤，添加push: true参数：

- name: Build and push image
  uses: docker/build-push-action@v4.0.0
  with:
    context: ${{ matrix.context }}
    platforms: ${{ matrix.platforms }}
    push: true  # 启用镜像推送
    tags: ${{ steps.metadata.outputs.tags }}
    labels: ${{ steps.metadata.outputs.labels }}

额外验证建议 #

1. 确认标签生成是否正确：可以在Generate docker image tags步骤后添加日志输出，检查生成的标签是否符合预期：

   - name: Print generated tags
     run: echo "Generated tags: ${{ steps.metadata.outputs.tags }}"
   

2. 核对Secrets权限：虽然手动推送正常，但再次确认GitHub仓库的DOCKER_USERNAME和DOCKER_PASSWORD Secrets是否正确，且对应账号有目标Docker Hub仓库的推送权限。
3. 标签逻辑优化：当前metadata-action的标签配置中，flavor: latest=false和type=raw,value=latest的组合是可行的，但可以确认在main分支推送时，enable=${{ github.ref == 'refs/heads/main' }}是否能正确触发latest标签生成。

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