Go github.com/gin-gonic/gin 一直报错 run 不起来

golang 0

发布于 2020-06-24

用go的gin框架来写写web接口。然而用文档的教程来运行，却死活都跑不起来，写下问题和解决方法。

首先简单的说下正常要运行一个项目步骤，我是windows环境：

### 安装golang

1. 下载安装包安装

2. 在cmd中输入go回车，有输出则说明安装正常

3. 一般安装的时候程序会自动添加，无需人工干预

### 检查GOPATH

1. 可以在cmd中查看set GOPATH

2. 或者在"我的电脑"-"属性"-"高级"-"环境变量"中查看和添加

3. 正常go安装，会自动添加，我本机GOPATH=C:\Users\Administrator\go；

### 安装gin

1. 接下来安装gin，框架文档介绍：go get -u github.com/gin-gonic/gin

2. 这时候开始遇到问题了，常遇问题资源加载不了，解决方法是使用代理（这块有个 go env 的命令，可以查看当前配置），在cmd中运行：

```
go env -w GO111MODULE=on

go env -w GOPROXY=https://goproxy.io,direct
```

3. 设置后，重新运行 `go get -u github.com/gin-gonic/gin` 可以很快速的安装

### 运行项目

1. 在 `C:\Users\Administrator\go\` 下创建 `src/gin/` 文件夹，创建 `main.go` 文件，添加文档说的代码：

```
package main

import "github.com/gin-goinc/gin"

func main() {
	r := gin.Default()

r.GET("/ping", func(c *gin.Context) {
	c.JSON(200, gin.H{
		"message": "pong",
		})
	})

r.Run() // listen and serve on 0.0.0.0:8080 (for windows "localhost:8080")
}
```

2. 在 cmd 中，进入 `C:\Users\Administrator\go\src\gin\` 目录，运行命令: `go run .\main.go`

3. 这时候问题又来了，报错： `main.go:3:8: cannot find module providing package github.com/gin-gonic/gin: working directory is not part of a module`

4. 解决方法，当前目录分别运行下面两句代码：

```
go mod init gin

go mod edit -require github.com/gin-gonic/gin@latest

go mod vendor
```

5. 上面运行后，再运行  go run .\main.go，就可行了。这其中涉及到go mod包依赖管理 ，类似前端npm的package.json，有兴趣可以深入了解

### 问题回顾

上面几点只是说明解决方法，这其中遇到的问题，甚至一度怀疑我安装的版本有问题

1. 我使用的是go 1.14.2，在运行gin的时候 go run .\main.go ，会报错：
```
main.go:3:8: cannot find module providing package github.com/gin-gonic/gin: working directory is not part of a module
```

2. 此时经过几次调试，发现如果运行 `go env -w GO111MODULE=off` （关闭模块管理）报错变成

```
main.go:3:8: cannot find package "github.com/gin-gonic/gin" in any of: c:\go\src\github.com\gin-gonic\gin (from $GOROOT) C:\Users\Administrator\go\src\github.com\gin-gonic\gin (from $GOPATH)
```

3. 这时 ` cannot find package "" in any of` 这个报错，就把我引到到设置 GOPATH 问题集合上，调试很久，发现并不能解决

4. 此时我怀疑起了代理设置，特别是 `go get` 之后包是放在  `$GOPATH\src\pkg` 下的，教程说是在 src 下面的，这点很是诡异， 当 `go env -w GO111MODULE=off` （关闭模块管理），这个时候 `go get` 命令是不走代理，而是走实际地址，下载速度异常慢，经常下载失败。但是模块包能被下载到 `$GOPATH/src` 目录下，这点和网上说的 go 目录结构一致，此时在 main.g o中 import 包，运行也不会报错（ gin 的包比较大，正常是下载失败的，我当时用 `go get github.com/astaxie/beedb` 试了另一个包）

5. gin 用 `go get` 下载是不会成功的，我直接在 github 下载包放在 `$GOPATH/src` 下，但是缺少依赖，无法运行，后续又把 `$GOPATH\src\pkg\mod` 中的包复制到 `$GOPATH\src` 还是不能运行。

6. 最后发现 gin 中有个 `go.mod` 的文件，查阅了相关资料，才找到解决方法。

### 总结

在使用 GOPROXY 的时候，开启了 `GO111MODULE` 导致包管理非官方所说的在  `$GOPATH\src\` 而是去了 `$GOPATH\src\pkg\` 目录下

此时就需要用 `go mod` 引入这些包 `require github.com/gin-gonic/gin@latest` 解决import获取不了包的问题。

本文来自：简书
感谢作者：passerby123
查看原文：我就想试试 [github.com/gin-gonic/gin，为什么死活都run不起来](https://www.jianshu.com/p/cd5acc7327ce "github.com/gin-gonic/gin，为什么死活都run不起来")

文明发言，争做净网小卫士。

昵称

邮箱