Docker构建Go应用无法复用主机缓存的原因及网络访问疑问

缓存未生效的原因 #

1. 缓存挂载路径错误：你用--mount=type=cache,target=/root/.cache/go-build仅缓存了Go编译阶段的构建缓存，但go mod download的依赖缓存实际存储在/go/pkg/mod（官方Golang镜像默认GOPATH为/go），这个关键路径未被纳入缓存范围，导致每次构建都重新下载依赖。
2. ADD指令触发层失效：先执行ADD . /srv复制整个项目目录，只要项目内任何文件（代码、配置等）发生变动，都会触发后续RUN指令重新执行。正确流程应优先复制依赖声明文件，再执行下载操作，仅当依赖文件变化时才重新下载。

修正后的Dockerfile示例：

FROM golang as builder
RUN apt update && apt upgrade -y
WORKDIR /srv
# 先复制依赖文件，利用Docker层缓存特性
COPY go.mod go.sum ./
RUN --mount=type=cache,target=/go/pkg/mod \
    --mount=type=cache,target=/root/.cache/go-build \
    go mod download
# 再复制其余代码文件
COPY . ./
RUN --mount=type=cache,target=/root/.cache/go-build \
    go generate ./... && \
    go build -o app cmd/main.go
CMD ["/srv/app"]

让docker build访问网络及复用本地go mod缓存 #

1. 访问主机网络 #

执行构建命令时添加--network=host参数，构建过程将直接使用主机网络栈：

docker build --network=host -t your-image .

2. 访问Docker Compose桥接网络 #

在docker-compose.yml的构建配置中指定目标网络（默认Compose桥接网络格式为项目名_default）：

services:
  your-service:
    build:
      context: .
      network: your-compose-network # 替换为实际的Compose网络名称，或直接用host

3. 复用主机本地go mod缓存 #

直接挂载主机的Go mod缓存目录到构建容器，需保证主机与容器Go版本一致避免兼容性问题：

docker build --mount=type=bind,source="$GOPATH/pkg/mod",target=/go/pkg/mod -t your-image .

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