构建Go Docker镜像时出现“No required module provides package”错误

问题核心是Docker构建容器内没有访问GitLab私有仓库的权限，而本地已通过Git凭证/密钥获取了私有模块，因此本地能正常运行。以下是几种实用解决方案：

方法一：通过SSH密钥授权访问私有仓库 #

1. 确保你的SSH公钥已添加到GitLab账号的SSH密钥列表中，本地能通过SSH正常拉取私有仓库。
2. 修改Dockerfile，在构建阶段配置SSH环境：

# syntax=docker/dockerfile:1

FROM golang:1.18-alpine

# 安装SSH客户端和Git（alpine镜像默认不含）
RUN apk add --no-cache openssh-client git

# 配置SSH信任GitLab主机，避免首次连接的确认提示
RUN mkdir -p /root/.ssh && \
    ssh-keyscan gitlab.com >> /root/.ssh/known_hosts

# 复制本地SSH私钥到容器（务必在.dockerignore中添加id_rsa，防止密钥泄露）
COPY id_rsa /root/.ssh/id_rsa
RUN chmod 600 /root/.ssh/id_rsa

WORKDIR /app

COPY go.mod ./
COPY go.sum ./
RUN go mod download

# 清理SSH密钥，减小镜像体积
RUN rm -rf /root/.ssh

COPY *.go ./
COPY dbutil/ ./dbutil/
COPY models/ ./models/

RUN go build -o /datapuller

EXPOSE 8080

CMD [ "/datapuller" ]

3. 创建.dockerignore文件排除密钥：

id_rsa

方法二：使用GitLab个人访问令牌（PAT）通过HTTPS拉取 #

1. 在GitLab账号中生成一个拥有read_repository权限的个人访问令牌。
2. 通过构建参数传递令牌，避免硬编码在Dockerfile中：
   修改后的Dockerfile：

# syntax=docker/dockerfile:1

FROM golang:1.18-alpine

WORKDIR /app

# 通过构建参数接收PAT，配置Git替换HTTPS地址
ARG GITLAB_PAT
RUN git config --global url."https://oauth2:${GITLAB_PAT}@gitlab.com/".insteadOf "https://gitlab.com/"

COPY go.mod ./
COPY go.sum ./
RUN go mod download

COPY *.go ./
COPY dbutil/ ./dbutil/
COPY models/ ./models/

RUN go build -o /datapuller

EXPOSE 8080

CMD [ "/datapuller" ]

3. 执行构建命令时传入令牌：

docker build --build-arg GITLAB_PAT=你的个人令牌 --tag datapuller .

方法三：挂载本地模块缓存（仅本地开发测试用） #

如果是本地构建，可直接挂载本地Go模块缓存到容器，复用已拉取的私有模块：

docker build --tag datapuller --mount=type=cache,target=/go/pkg/mod .

此方法无需修改Dockerfile，但仅适合本地开发，CI/CD环境不适用。

额外注意事项 #

• 确保本地已执行go mod tidy，生成正确的go.mod和go.sum文件。
• 如果私有模块是当前项目的子目录，可在go.mod中添加replace指令指向本地路径：

replace gitlab.com/mycorp/mycompany/data/datapuller/dbutil => ./dbutil
replace gitlab.com/mycorp/mycompany/data/datapuller/models => ./models

同时在Dockerfile中复制对应的子目录文件。

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