解决go mod/git get访问GitLab私有仓库403 Forbidden问题

问题分析 #

核心问题是Go无法通过正确权限拉取私有GitLab模块，常见诱因包括私有仓库路径配置不匹配、Git协议转换未生效、SSH密钥权限异常等。

修复步骤 #

1. 修正Go环境变量的私有仓库路径匹配 #

检查GOPRIVATE、GONOPROXY、GONOSUMDB配置，确保路径与实际仓库分组完全一致：

• 你的仓库路径为gitlab.com/groups/private-repo，但报错中引用的是gitlab.com/group/other-private-repo，存在分组名称不一致（groups vs group）的问题，需统一修正。
• 执行以下命令更新环境变量（根据实际分组调整）：

go env -w GOPRIVATE="gitlab.com/groups/*,github.com/username/*"
go env -w GONOPROXY="gitlab.com/groups/*"
go env -w GONOSUMDB="gitlab.com/groups/*,github.com/username/*"

2. 确保Git的insteadOf配置全局生效 #

你的.gitconfig已配置HTTPS转SSH，但需验证配置是否全局生效：

• 执行git config --global --list，确认输出中存在url.ssh://git@gitlab.com/.insteadof=https://gitlab.com/。
• 若仅为局部配置，重新执行全局配置命令：

git config --global url."ssh://git@gitlab.com/".insteadOf "https://gitlab.com/"
git config --global url."ssh://git@github.com/".insteadOf "https://github.com/"

3. 配置Go版本控制系统（GOVCS） #

Go 1.16+需明确私有仓库的VCS访问方式，添加以下环境变量：

go env -w GOVCS="gitlab.com/groups/*:git,github.com/username/*:git"

此配置强制Go使用Git协议拉取指定私有仓库模块，避免HTTP访问权限问题。

4. 验证SSH密钥权限 #

• 测试GitLab SSH连接有效性：

ssh -T git@gitlab.com

返回Welcome to GitLab, @username!则密钥有效；若报错，检查本地密钥文件权限（需设为600）、GitLab平台是否正确添加公钥。

5. 清理缓存并重新拉取模块 #

• 清理本地模块缓存：

go clean -modcache

• 重新执行go mod tidy，此时应能正常拉取私有模块。

额外排查点 #

• 检查go.mod中引用的私有模块路径，避免拼写错误（比如报错中出现的itlab.com而非gitlab.com笔误）。
• 若为团队仓库，确认你的GitLab账号拥有目标私有仓库的读取权限。

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