You need to enable JavaScript to run this app. 如何解决Go语言go mod tidy报错x509: certificate signed by unknown authority
优惠活动
大模型
产品
解决方案
定价
更多

如何解决Go语言go mod tidy报错x509: certificate signed by unknown authority

问题根因

报错核心是Go访问依赖代理服务时,SSL证书无法通过系统信任链校验,通常由以下原因导致:

  • 本地设置了未被系统信任的中间人网络代理(公司内网代理、杀毒软件流量监控代理等)
  • 使用了默认的proxy.golang.org代理,国内网络访问时存在证书解析或代理拦截问题
  • 旧版本Go的-insecure参数已废弃,之前使用的调试参数不生效
解决方案

方案1:替换为国内可信任的Go依赖代理(优先级最高)

默认的proxy.golang.org在国内访问不稳定,优先替换为国内公共代理:

  1. 执行以下命令临时生效(仅当前终端窗口):
export GOPROXY=https://goproxy.cn,direct
  1. 如需永久生效,将上述配置写入你的shell配置文件(~/.bashrc/~/.zshrc/~/.profile任选其一),执行source 对应配置文件后生效
  2. 重新执行go mod tidy验证问题是否解决

方案2:手动导入代理根证书到系统信任链

如果替换代理后仍报错,说明你的网络存在中间人拦截,需要将拦截代理的根证书导入系统:

  1. 导出当前访问的Go代理服务根证书,以goproxy.cn为例:
openssl s_client -connect goproxy.cn:443 < /dev/null | sed -n '/-----BEGIN CERTIFICATE-----/,/-----END CERTIFICATE-----/p' > goproxy.crt
  1. 将证书存入系统CA目录并更新信任链:
sudo cp goproxy.crt /usr/local/share/ca-certificates/
sudo update-ca-certificates
  1. 重新执行go mod tidy验证

方案3:临时跳过SSL证书校验(仅测试用,不建议长期使用)

如果上述方案都无法生效,可通过Go官方提供的环境变量跳过指定域名的SSL校验,之前使用的-insecure参数在Go 1.14及之后版本已废弃,需使用环境变量:

# 指定需要跳过校验的域名,多个域名用逗号分隔
export GOINSECURE=proxy.golang.org,gonum.org,goproxy.cn
# 重新执行依赖拉取
go mod tidy

排查参考

执行go env | grep -E 'GOPROXY|GOINSECURE'查看当前Go环境的代理相关配置,和同事的正常配置做对比,确认是否存在自定义配置差异。

内容的提问来源于stack exchange,提问作者Uzair

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.20 09:45:03