Github Actions中docker build的go相关命令缓存不生效如何解决

核心问题及修复步骤 #

1. 移除Dockerfile中不必要的go mod tidy命令 #

你当前Dockerfile里的RUN go mod tidy是缓存失效的核心诱因：本地提交的go.mod、go.sum是固定版本，但CI环境执行go mod tidy时，若对应依赖有符合版本规则的新版本发布，会自动更新依赖列表，导致后续go mod download、go build层全部发生变化，无法命中缓存。直接删除该行即可，依赖安装只需保留RUN go mod download。

2. 固定基础镜像版本避免浮动标签干扰 #

你使用的golang:latest、alpine:latest属于浮动标签，Github Action每次运行时都会拉取当前最新的对应镜像，只要镜像的digest和上一次构建时不一致，后续所有构建层都会直接失效。可将基础镜像替换为固定digest的稳定版本：

# 示例，可自行替换为你需要的版本对应的digest
FROM golang:1.22@sha256:4ef13b89b69a752c5496551cfc6898b98e19fbda40d951f74e8d66fba4b7dd6c as builder
...
FROM alpine:3.20@sha256:0a4eaa0eecf5f8c050e5bba433f78c0555707769245a74cf89a228ad63c1699b

如果不需要每次拉取最新基础镜像，也可以在docker/build-push-action参数中添加pull: false，避免主动更新本地已存在的基础镜像。

3. 优化缓存key的哈希规则 #

当前缓存key仅哈希了Dockerfile内容，go.mod、go.sum的变动不会触发缓存更新，也可能导致缓存匹配异常。同时建议升级不再维护的actions版本，修改后的缓存配置如下：

- name: Cache Docker layers
  uses: actions/cache@v3
  with:
    path: /tmp/.buildx-cache
    # 将go.mod、go.sum加入哈希计算，依赖变动时才生成新缓存
    key: ${{ runner.os }}-buildx-${{ hashFiles('**/Dockerfile', '**/go.mod', '**/go.sum') }}
    restore-keys: |
      ${{ runner.os }}-buildx-

4. 固定buildkit版本避免缓存兼容性问题 #

不同版本的buildkit生成的缓存结构可能不兼容，给docker/setup-buildx-action添加固定版本参数，确保构建环境一致：

- name: Set up Docker Buildx
  uses: docker/setup-buildx-action@v2
  with:
    driver-opts: image=moby/buildkit:v0.12.0

5. 补充build-push-action的明确配置 #

升级插件版本并明确指定构建上下文，避免默认参数异常：

- name: Build docker image 1
  uses: docker/build-push-action@v4
  with:
    context: .
    push: false
    tags: go-docker-caching:${{ steps.getDockerTag.outputs.image_tag }}
    cache-from: type=local,src=/tmp/.buildx-cache
    cache-to: type=local,dest=/tmp/.buildx-cache,mode=max

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