自建Gitlab CI/CD共享Runner报错：go: command not found求助

问题背景 #

自建GitLab服务器，开展CI/CD流水线构建发布POC验证，编写了.gitlab-ci.yml配置。使用共享Runner（ID: GJ7z2Aym）时持续报错：

bash: line 132: go: command not found

但注册专属Runner后，流水线可正常执行。

根因分析 #

• 共享Runner的运行环境（宿主机或Docker镜像）未预装Go语言环境，导致构建脚本无法找到go命令。
• 专属Runner所在的运行环境（注册时指定的机器或镜像）已配置好Go环境，因此能顺利执行Go相关构建步骤。

解决方案 #

1. 为共享Runner配置Go环境 #

• Shell模式Runner：直接在共享Runner所在服务器上安装Go，配置PATH、GOPATH环境变量，确保gitlab-runner用户能正常执行go命令。
• Docker模式Runner：修改Runner配置，指定包含Go的官方镜像作为默认镜像；或在.gitlab-ci.yml的job中显式指定镜像：

  build_job:
    image: golang:1.21
    script:
      - go version
      # 你的构建命令
  

2. 在CI脚本中动态安装Go #

若无法修改共享Runner基础配置，可在构建脚本开头添加Go安装步骤，示例：

# 安装Go 1.21版本（根据项目需求调整版本）
wget https://dl.google.com/go/go1.21.0.linux-amd64.tar.gz
sudo rm -rf /usr/local/go && sudo tar -C /usr/local -xzf go1.21.0.linux-amd64.tar.gz
export PATH=$PATH:/usr/local/go/bin
go version

将上述代码加入.gitlab-ci.yml的script字段最前端，确保构建前完成Go环境安装。

3. 检查共享Runner执行上下文 #

• Shell模式下，确认gitlab-runner用户的环境变量包含Go的路径；
• Docker模式下，验证使用的镜像是否包含所有必要的构建依赖。

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