自托管Runner拉取GitHub私有Go模块认证失败求助

以下是针对你遇到的remote: Repository not found. fatal: Authentication failed错误的排查和解决步骤：

1. 验证权限与环境变量有效性 #

• 检查PAT权限：确认你的GitHub个人访问令牌（GITPAT）已勾选repo权限，且令牌所属账号有权访问目标私有仓库。可在Runner实例上手动执行克隆命令测试：

  git clone https://<你的PAT>:x-oauth-basic@github.com/<MY_ORG>/<MY_REPO>
  

• 确认环境变量传递：在workflow中添加调试步骤，验证GOPRIVATE和TOKEN是否正确加载：

  - name: 调试环境变量
    run: |
      echo "GOPRIVATE值: $GOPRIVATE"
      echo "TOKEN是否存在: $([ -n "$TOKEN" ] && echo "是" || echo "否")"
  

  注意GOPRIVATE应覆盖所有需要访问的私有模块路径，比如组织下所有仓库设为github.com/<MY_ORG>/*，而非单个仓库。

2. 修正Git配置的变量替换逻辑 #

你的workflow中git config步骤可能存在环境变量解析问题，建议直接引用GitHub Secrets而非依赖环境变量传递：

- name: 配置Git访问私有模块
  run: git config --global url."https://${{ secrets.GITPAT }}:x-oauth-basic@github.com/".insteadOf "https://github.com/"

如果之前有残留的Git配置，可先清理再设置：

- name: 重置并配置Git全局规则
  run: |
    git config --global --unset-all url."https://github.com/".insteadOf
    git config --global url."https://${{ secrets.GITPAT }}:x-oauth-basic@github.com/".insteadOf "https://github.com/"

3. 配置Go私有模块专属环境 #

添加GONOSUMDB避免Go尝试从公共sumdb拉取私有模块信息，在workflow的env块中增加：

env:
  # ...其他已有变量
  GONOSUMDB: github.com/<MY_ORG>/*

或者在步骤中直接设置Go环境：

- name: 配置Go私有模块参数
  run: go env -w GONOSUMDB=github.com/<MY_ORG>/*

4. 验证Runner的Git配置生效 #

在workflow中添加步骤检查当前Git全局配置：

- name: 查看Git全局配置
  run: git config --global --get-regexp url

确认输出中包含正确的insteadOf规则，即https://<你的PAT>:x-oauth-basic@github.com/替换https://github.com/。

5. 检查Runner运行用户权限 #

自托管Runner通常以特定用户（如ubuntu）运行，确保该用户的Git全局配置能正常生效。可在Runner实例上切换到对应用户，手动执行Git配置命令并验证。

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