如何在Go的Docker多阶段构建中添加本地项目依赖？

我来帮你解决这个Docker多阶段构建时找不到本地Go依赖的问题，其实核心问题是你在容器里没有把整个项目的目录结构放到GOPATH的正确位置，导致Go编译器找不到backend下的包。

先分析下你当前Dockerfile的问题：

• 你用ADD . github.com/dalderman77/phacts/backend/conduit和ADD . github.com/dalderman77/phacts/backend/storage这两条命令是错误的，它们会把cron_job目录下的内容复制到这两个路径里，完全打乱了原本的项目结构。
• 后面的COPY . .也只是复制了cron_job目录的内容，没有把backend目录的内容带到容器里，自然找不到依赖。

接下来给你两种解决方案，一种适配你当前的Go 1.10版本（基于GOPATH），另一种是升级Go版本后用Go Modules的更优雅方案：

方案一：适配Go 1.10（GOPATH模式） #

修改你的cron_job/Dockerfile如下：

# 第一阶段：构建二进制文件
FROM golang:1.10.1 as builder

# 先切换到GOPATH下的项目根目录
WORKDIR /go/src/github.com/dalderman77/phacts

# 把本地整个项目根目录（包含backend和cron_job）复制到容器内的对应路径
COPY . .

# 切换到cron_job目录进行构建
WORKDIR /go/src/github.com/dalderman77/phacts/cron_job

# 获取外部依赖包
RUN go get -d -v cloud.google.com/go/datastore golang.org/x/net/context

# 编译静态二进制文件，确保在alpine容器里能运行
RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o main .

# 第二阶段：构建轻量运行容器
FROM alpine:latest
RUN apk --no-cache add ca-certificates
WORKDIR /root/
# 从构建阶段复制编译好的二进制文件
COPY --from=builder /go/src/github.com/dalderman77/phacts/cron_job/main .
CMD ["./main"]

为什么这样改能解决问题？ #

• 我们把整个项目根目录直接复制到/go/src/github.com/dalderman77/phacts/下，这样容器里的目录结构就和本地完全一致了：phacts/backend/和phacts/cron_job/都在GOPATH的正确位置。
• 当Go编译cron_job的代码时，import的github.com/dalderman77/phacts/backend/conduit就能直接找到/go/src/github.com/dalderman77/phacts/backend/conduit下的代码，和本地编译的逻辑完全一致。

方案二：升级Go版本后使用Go Modules（推荐） #

如果你能把Go版本升级到1.11及以上，Go Modules可以让你脱离GOPATH的限制，构建更灵活。步骤如下：

1. 在项目根目录（也就是包含backend和cron_job的目录）下执行：

go mod init github.com/dalderman77/phacts

2. 修改cron_job/Dockerfile为：

FROM golang:1.21 as builder
WORKDIR /app

# 先复制go mod文件，利用Docker缓存加快构建
COPY go.mod go.sum ./

# 复制backend目录（因为cron_job依赖它）
COPY backend/ ./backend/
# 复制cron_job目录
COPY cron_job/ ./cron_job/

# 切换到cron_job目录构建
WORKDIR /app/cron_job
RUN go build -o main .

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

这种方式不需要依赖GOPATH，Go会自动识别项目模块，处理本地依赖，构建流程更清晰。

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