Go项目Docker构建时无法识别本地私有依赖如何解决？

问题根因 #

你的构建失败核心是容器内代码路径和导入路径不匹配：

• 你的go.mod声明的模块名是<private-repo-url>，业务代码存放在本地项目的src目录下，所以本地bootstrap包的路径是src/cmd/http-api/bootstrap，对应正确导入路径为<private-repo-url>/src/cmd/http-api/bootstrap
• 你的Dockerfile中使用ADD ./src .复制代码，会把本地src目录下的所有内容直接平铺到容器的/balrog工作目录，导致容器内bootstrap包的实际路径变成/balrog/cmd/http-api/bootstrap，和代码里写的导入路径完全对不上，go构建工具找不到对应包就会尝试去远程仓库拉取，所以会报错。

无需私有仓库凭证的解决方案 #

推荐采用第一种方案，无需修改业务代码：

方案1：调整Dockerfile代码复制逻辑，保留src目录层级 #

修改代码复制指令，让容器内的路径和本地保持一致，修改后的完整Dockerfile如下：

FROM golang:1.17

WORKDIR /balrog

# 复制依赖定义并下载
ADD go.mod .
ADD go.sum .
RUN go mod download

# 保留src目录层级复制代码，不要平铺
ADD ./src ./src

ENV CGO_ENABLED=0
ENV GOOS=linux
ENV GOARCH=amd64
# 构建时指定入口文件所在路径
RUN go build -a -o ./server ./src/cmd/http-api/

# 运行服务
CMD ["/balrog/server"]

调整后容器内的代码路径和本地完全一致，go构建工具可以直接在本地模块内找到对应包，不会触发远程仓库拉取。

方案2：调整代码导入路径（可选） #

如果你不想保留src目录层级，可以把业务代码里所有导入路径的/src前缀去掉，比如把<private-repo-url>/src/cmd/http-api/bootstrap改成<private-repo-url>/cmd/http-api/bootstrap，和Docker内平铺后的路径匹配即可。

之前尝试replace失败的原因 #

你添加replace指令后没有执行go mod tidy同步依赖信息，所以go工具还是识别不到本地模块和已经下载的第三方依赖，而且本质问题路径不匹配没有解决，所以仍然报错。

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