React应用GitHub Actions CI/CD配置报错：Buildx摘要格式无效

针对你遇到的Buildx failed with: ERROR: failed commit on ref "manifest-sha256:xxx": invalid content digest in response: invalid checksum digest format错误，以下是几个可行的解决方法：

1. 明确指定构建平台 #

多平台构建可能与私有Registry的兼容性冲突，可在构建步骤中指定与自托管Runner匹配的单一平台：

修改build-backend任务中的Build and push步骤，添加platforms参数：

- name: Build and push
  uses: docker/build-push-action@v5
  with:
    push: true
    tags: ${{ steps.string.outputs.lowercase }}
    platforms: linux/amd64
    build-args: |
      REACT_APP_BASENAME=${{ env.REACT_APP_BASENAME }}
      NGINX_AUTH_USERNAME=${{ secrets.NGINX_AUTH_USERNAME }}
      NGINX_AUTH_PASSWORD=${{ secrets.NGINX_AUTH_PASSWORD }}

2. 调整Buildx的Digest验证配置 #

如果你的私有Registry环境可信，可临时禁用Buildx的Digest安全验证：

修改Set up Docker Buildx步骤，添加自定义配置：

- name: Set up Docker Buildx
  uses: docker/setup-buildx-action@v3
  with:
    config-inline: |
      [registry."${{ secrets.REGISTRY_HOST }}"]
        http = true
        insecure = true
        [registry."${{ secrets.REGISTRY_HOST }}".digest]
          security.insecure = true

3. 检查Registry地址格式 #

确保secrets.REGISTRY_HOST的值为纯域名/IP（不带http://或https://前缀），例如registry.example.com而非https://registry.example.com。错误的地址格式会导致Buildx解析Digest时出错。

4. 升级Docker相关Actions版本 #

旧版本的Docker Actions可能存在Digest处理bug，建议升级到最新稳定版：

• 将docker/setup-qemu-action@v2升级为v3
• 将docker/setup-buildx-action@v2升级为v3
• 将docker/build-push-action@v3升级为v5
• 将docker/login-action@v2升级为v3

5. 检查Docker Registry版本 #

确保私有Docker Registry版本≥2.3.0，旧版本对新Digest格式支持不完善。可通过以下命令查看版本：

curl -s ${{ secrets.REGISTRY_HOST }}/v2/ | jq .

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