问题分析 #

当前配置的核心问题是Go模块缓存未被BuildKit有效复用：Dockerfile中go mod download步骤没有挂载模块缓存目录，导致每次构建都重新下载依赖；同时GitHub Action的缓存配置仅针对镜像构建层，未覆盖Go模块的缓存逻辑。

解决方案 #

1. 优化Dockerfile（添加Go模块缓存挂载） #

修改builder阶段的go mod download步骤，通过BuildKit的缓存挂载复用/go/pkg/mod目录（Go模块默认存储路径）：

FROM golang:1.23.2 AS builder

WORKDIR /app
COPY go.mod go.sum ./
# 挂载Go模块缓存，仅在go.mod/go.sum变更时重新下载
RUN --mount=type=cache,target=/go/pkg/mod \
    go mod download
COPY . .
ENV GOCACHE=/root/.cache/go-build
RUN --mount=type=cache,target="/root/.cache/go-build" \
    CGO_ENABLED=0 GOOS=linux go build -v -o main ./src/

FROM alpine:latest
RUN apk --no-cache add ca-certificates
WORKDIR /app
COPY --from=builder /app/main .
CMD ["./main"]

2. 优化GitHub Action配置（增强缓存策略） #

调整docker/build-push-action的缓存参数，同时使用GitHub Actions内置缓存和Registry缓存，确保缓存跨构建复用：

- name: Build and push Docker image
  uses: docker/build-push-action@v5
  with:
    context: .
    file: docker/Dockerfile
    push: true
    tags: |
      ghcr.io/org/app:latest
      ghcr.io/org/app:${{ github.sha }}
    platforms: linux/amd64
    # 从Registry缓存和GitHub Actions缓存拉取
    cache-from: |
      type=registry,ref=ghcr.io/org/app:buildcache
      type=gha
    # 将缓存推送到Registry（持久化）和GitHub Actions（快速复用）
    cache-to: |
      type=registry,ref=ghcr.io/org/app:buildcache,mode=max
      type=gha,mode=max

关键说明 #

• 模块缓存逻辑：通过--mount=type=cache,target=/go/pkg/mod，BuildKit会在本地保留模块缓存，只有当go.mod或go.sum文件变更时，才会触发重新下载。
• 双缓存策略：type=gha利用GitHub内置缓存服务，速度更快；type=registry将缓存持久化到容器仓库，适合跨 runner 或长期复用。mode=max会保存所有缓存层，最大化复用效率。
• 首次构建：第一次运行仍会下载所有依赖，但后续构建只要go.mod/go.sum未修改，就能完全复用缓存，大幅缩短构建时间。

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