Windows WSL2环境下Docker容器运行Go服务报外部依赖包缺失错误

• 你使用的golang:1.16.3-buster镜像，从Go 1.16版本开始默认开启GO111MODULE=on模块模式，但你的项目没有生成go.mod、go.sum依赖声明文件，也没有调整项目路径适配GOPATH规则。
• 构建阶段执行的go get命令，在模块模式下无依赖声明文件的场景，不会把依赖安装到运行时可查找的GOPATH路径下，仅临时拉取到模块缓存，运行go run时无法识别这些依赖。
• 原有Dockerfile的工作目录/code，如果走GOPATH模式也不符合「项目必须放在$GOPATH/src下」的规则，进一步加剧了包查找失败的问题。

优先推荐使用Go Modules模式（适配Go 1.16的默认行为，长期维护更方便）：

方案一：使用Go Modules（推荐） #

1. 先在本地项目根目录（也就是存放Dockerfile的后端目录）执行以下操作：
   • 初始化模块：go mod init server（模块名可自定义，不影响功能）
   • 把项目中所有相对路径导入（比如api "./api"）替换为「模块名+包路径」的格式，比如api "server/api"（适配Go Modules的导入规则）
   • 自动解析所有依赖，生成go.mod和go.sum：go mod tidy

   执行完成后会自动把你用到的go.mongodb.org/mongo-driver、github.com/google/uuid等所有依赖的版本、子包都固化到声明文件中。

2. 替换原有Dockerfile为以下内容：

   FROM golang:1.16.3-buster
   WORKDIR /code
   # 先复制依赖声明文件，利用Docker构建缓存，后续只要依赖没变动就不会重复下载
   COPY go.mod go.sum ./
   # 按声明文件下载所有依赖
   RUN go mod download
   # 复制项目全部代码
   COPY . .
   # 可选优化：先编译成二进制再运行，启动速度更快、镜像体积更小
   RUN go build -o server .
   # 启动命令，也可以保留你原来的`CMD ["go", "run", "main.go"]`
   CMD ["./server"]
   

3. 重新执行构建、运行命令即可。

如果不想修改项目现有的相对路径导入逻辑，也可以走GOPATH模式：

方案二：适配原有GOPATH运行逻辑 #

修改Dockerfile，强制关闭模块模式、调整项目路径到GOPATH规定位置：

FROM golang:1.16.3-buster
# 强制关闭模块模式，使用GOPATH规则
ENV GO111MODULE=off
# 把工作目录设置为GOPATH下的src路径，符合GOPATH模式要求
WORKDIR /go/src/server
# 安装依赖，此时go get会自动安装到GOPATH的src目录下
RUN go get go.mongodb.org/mongo-driver/mongo
RUN go get github.com/google/uuid
# 复制项目代码到规定路径
COPY . .
CMD ["go", "run", "main.go"]

你之前本地能正常运行是因为本地开发环境大概率默认开启了GOPATH模式，和容器内Go 1.16的默认模块模式不兼容，上述两种方案任选其一即可解决依赖找不到的问题。

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