GitLab流水线中Go项目无法获取公共依赖模块的问题求助

问题根源分析 #

1. 使用完整模块路径gitlab.com/nrs16/util时，CI Runner拉取模块触发Git认证提示，但终端被禁用导致失败（即便仓库是公开的，GitLab的HTTPS访问有时仍会触发该提示）。
2. 改为短名util导入时，Go无法在标准库或模块缓存中找到对应包，因为Go模块要求导入路径必须与go.mod声明的完整模块名完全匹配。

解决方案 #

步骤1：恢复正确的模块导入配置 #

• 将main.go中的导入语句改回完整路径：

  middleware "gitlab.com/nrs16/util"
  

• 确保authentication项目的go.mod包含正确的依赖声明（本地运行正常则此步骤已完成）：

  require gitlab.com/nrs16/util vx.x.x // 替换为实际版本号或伪版本号
  

步骤2：确认middleware仓库为公开状态 #

登录GitLab，进入gitlab.com/nrs16/util仓库的设置 > 通用 > 可见性、项目功能、权限，将仓库可见性设置为公开。

步骤3：配置CI环境匿名拉取公开模块 #

在.gitlab-ci.yml的script段添加Git配置，规避认证提示：

stages:
  - build

variables:
  GO111MODULE: "on"

build:
  stage: build
  image: golang:1.21.0
  script:
    # 配置Git使用HTTPS访问GitLab，避免SSH认证
    - git config --global url."https://gitlab.com/".insteadOf "git@gitlab.com:"
    # 解决可能的SSL验证问题（可选）
    - git config --global http.https://gitlab.com/.sslVerify false
    # 执行模块整理与构建
    - go mod tidy
    - go build -o authentication ./src/*.go
  artifacts:
    paths: 
      - authentication # 修正路径，与go build输出的二进制文件名对应

备选方案：通过Go代理拉取模块 #

若直接拉取仍有问题，可配置GOPROXY使用官方代理，绕过直接访问GitLab：

variables:
  GO111MODULE: "on"
  GOPROXY: "https://proxy.golang.org,direct"

将上述变量添加到.gitlab-ci.yml的variables区块，再执行模块整理和构建命令。

备选方案：指定模块伪版本号（无tag时） #

若middleware仓库未打版本tag，Go会使用伪版本号。在本地执行以下命令获取最新伪版本号：

go list -m gitlab.com/nrs16/util@latest

将结果中的版本号添加到authentication的go.mod中，例如：

require gitlab.com/nrs16/util v0.0.0-20240520123456-abcdef123456

推送修改后的go.mod到GitLab，CI即可拉取对应版本的模块。

注意事项 #

• 不要将模块名改为短名util，Go模块的导入路径必须与go.mod中声明的模块名完全一致。
• 确认CI生成的二进制文件路径正确，原配置中的src/.authentication应为authentication（与go build -o authentication的输出对应）。

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