因网络问题导致 Go 语言依赖包下载慢或失败的几个解决方案
Go 语言由 Google 公司开发,由于众所周知的原因,托管 Go 语言包的某些域名可能在国内被屏蔽,比如 golang.org
、google.com
等,因此,当我们下载托管在这些域名的包时,会出现网络问题导致的下载失败,以 google.golang.org/grpc
这个包为例,当我们下载它时,会出现如下错误提示:
即:
Fetching https://google.golang.org/grpc?go-get=1
https fetch failed: Get https://google.golang.org/grpc?go-get=1: dial tcp 216.239.37.1:443: i/o timeout
package google.golang.org/grpc: unrecognized import path "google.golang.org/grpc" (https fetch: Get https://google.golang.org/grpc?go-get=1: dial tcp 216.239.37.1:443: i/o timeout)
要解决这类问题,有以下三种方案:
友情提示:最新版本 Golang(1.11+)建议使用 Go Moudles + GoProxy 管理依赖。
1、VPN
如果你有可以访问国外站点权限的 VPN,设置通过该 VPN 访问 google.golang.org
(这种方式最简单)。
2、git clone && go install
如果没有 VPN,Go 语言版本又在 1.11 以下,不支持 Go Module 功能,可以通过如下方式从 github.com
将对应项目克隆到本地 $GOPATH/src
目录下:
cd $GOPATH/src
git clone https://github.com/grpc/grpc-go.git google.golang.org/grpc
此外,还要克隆 google.golang.org/grpc
依赖的其他包(依赖哪些包可以在运行 go install
报错时看到):
git clone https://github.com/golang/net.git golang.org/x/net
git clone https://github.com/golang/text.git golang.org/x/text
git clone https://github.com/google/go-genproto.git google.golang.org/genproto
接下来,通过如下命令安装 Golang Protobuf 包:
go get -u -v github.com/golang/protobuf/proto
go get -u -v github.com/golang/protobuf/protoc-gen-go
最后,通过 go install
命令手动安装这个扩展包:
go install google.golang.org/grpc
3、go module
对于 Go 1.11 及以上版本,支持 Go Module 功能,Go Module 是一个新型的包管理工具,我们创建一个新项目,比如 helloworld
,并且在该目录下运行如下命令来初始化 Go Module:
go mod init helloworld
这会在当前目录下生成一个 go.mod
文件:
然后在当前目录下新建一个测试文件 main.go
并初始化代码如下:
package main
import "google.golang.org/grpc"
func main() {
grpc.NewServer()
}
接下来运行如下命令将 google.golang.org/grpc
源替换为 github.com/grpc/grpc-go@latest
:
go mod edit -replace=google.golang.org/grpc=github.com/grpc/grpc-go@latest
然后下载并更新依赖,它会自动下载 main.go
中声明的导入包:
go mod tidy
此时会报错:
说明 google.golang.org/grpc
依赖其他包,我们需要一一将对应源替换为 github.com
项目:
go mod edit -replace=golang.org/x/tools@v0.0.0-20190524140312-2c0ae7006135=github.com/golang/tools@v0.0.0-20190524140312-2c0ae7006135
go mod edit -replace=google.golang.org/genproto@v0.0.0-20180817151627-c66870c02cf8=github.com/google/go-genproto@v0.0.0-20180817151627-c66870c02cf8
go mod edit -replace=google.golang.org/appengine@v1.1.0=github.com/golang/appengine@v1.1.0
go mod edit -replace=golang.org/x/oauth2@v0.0.0-20180821212333-d2e6202438be=github.com/golang/oauth2@v0.0.0-20180821212333-d2e6202438be
go mod edit -replace=golang.org/x/net@v0.0.0-20190311183353-d8887717615a=github.com/golang/net@v0.0.0-20190311183353-d8887717615a
go mod edit -replace=golang.org/x/sys@v0.0.0-20190215142949-d0b11bdaac8a=github.com/golang/sys@v0.0.0-20190215142949-d0b11bdaac8a
go mod edit -replace=golang.org/x/lint@v0.0.0-20190313153728-d0100b6bd8b3=github.com/golang/lint@v0.0.0-20190313153728-d0100b6bd8b3
go mod edit -replace=cloud.google.com/go@v0.26.0=github.com/googleapis/google-cloud-go@v0.26.0
再次运行 go mod tidy
即可,如果运行过程中出现其他 golang.org
域名下的包下载失败,则继续替换。go mod tidy
执行成功后会在当前目录下生成一个 go.sum
文件,用于存放每个依赖库的版本和哈希值。
最后把依赖复制到 vendor
目录:
go mod vendor
这个时候,你可以看到 helloworld
的目录结构变成了这样子:
接下来,我们可以通过从 vendor
目录查找依赖来构建程序,该命令会在当前目录下生成 helloworld 二进制程序:
go build -mod=vendor
这就脱离了传统的通过 $GOPATH
路径查找依赖的包管理方式。
4、go module & GOPROXY
对于 Go 1.11 及以上版本,在开启 Go Module 支持的情况下(1.13及以上版本默认开启),还可以通过代理服务来完成 Go 依赖包的下载,这样处理起来比上述第三种方案更加快捷,我们无需手动替换下载源,所有依赖会自动从代理的镜像地址下载。
下面我们创建一个新的测试目录 helloworld2
,并初始化 Go Module:
go mod init helloworld2
然后运行如下命令导出 GOPROXY
环境变量(Windows 下通过设置系统环境变量 GOPROXY
来实现):
export GOPROXY=https://goproxy.cn
注:以上是七牛云提供的代理地址,还可以使用阿里云提供的代理
https://mirrors.aliyun.com/goproxy/
,或者 Go 官方提供的全球代理https://goproxy.io
。
如果你是在 GoLand 中开发,还可以通过 Preferences->Go->Go Modules 来配置 Proxy 设置:
或者干脆直接通过 Go Modules 创建新项目:
然后在项目根目录下新增 main.go
,并初始化代码如下(和第三种方案一样):
package main
import "google.golang.org/grpc"
func main() {
grpc.NewServer()
}
接下来,运行 go mod tidy
自动下载依赖包 google.golang.org/grpc
,除了该依赖包之外,依赖包本身依赖的其他依赖包也会通过镜像代理地址下载,不需要一个个去替换下载源,非常快捷方便。
接下来,可以运行 go mod vendor
将依赖复制到 vendor
目录下,此时我们会看到项目目录结构已经和第三步一样了:
注:
go vendor
操作可选,官方不建议这么做。
go.mod
也非常干净:
module helloworld2
go 1.12
require google.golang.org/grpc v1.23.0
main.go
中声明的所有依赖都已经下载完成。
综合比较下来,如果你的 Go 语言版本是1.11+,推荐使用代理的方式来下载 Go 依赖包。
12 Comments
确实 毕竟许式伟是国内最早的 Go 语言布道者之一
windows下使用如下命令设置代理: