Dockerfile构建Golang项目报错：cloudmeta包不在GOROOT中

问题根源 #

你遇到的错误是因为Dockerfile里的模块初始化时机不对，且模块路径与实际代码目录结构不匹配，导致Go无法定位到cloudmeta/backend/handlers包。

具体修复步骤 #

1. 本地提前初始化Go模块 #

在你的本地项目根目录执行以下命令，生成go.mod文件（不要在Docker构建过程中做这一步）：

go mod init cloudmeta

生成的go.mod要和代码一起放入构建上下文，让Docker能读取到正确的模块配置。

2. 修改Dockerfile #

调整Dockerfile的构建逻辑，适配Go模块机制，同时优化构建缓存：

FROM golang:1.19

# 设置工作目录为/app
WORKDIR /app

# 先复制go.mod和go.sum，利用Docker缓存避免重复下载依赖
COPY go.mod go.sum ./
RUN go mod download

# 复制所有代码文件到工作目录
COPY . .

# 构建可执行文件，.表示当前模块的主包
RUN go build -o bin/cloudmeta .

# 启动应用
CMD ["./bin/cloudmeta"]

3. 确认代码中的导入路径 #

确保代码里导入子包时使用模块前缀：

import "cloudmeta/backend/handlers"

因为你的模块名称是cloudmeta，子包路径需要基于这个模块名来编写，Go才能正确找到对应的文件。

为什么原来的Dockerfile会出错？ #

你之前先把代码放到/go/src/myapp，再执行go mod init cloudmeta，此时模块根目录是/go/src/myapp，但代码里的导入路径是cloudmeta/backend/handlers，Go会去/go/src/cloudmeta/backend/handlers找文件（而实际文件在/go/src/myapp/backend/handlers），自然找不到对应的包。

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