【etcd】go使用etcd踩坑记录

一、环境

• golang版本:1.19(刚从1.15换过来的)
• 系统:win7，centos7
• IDE:goland

二、安装etcd

  etcd服务端安装过程网上都挺详细的，参考这篇教程，直接用docker安装，简单方便。

三、使用etcd

  到目前为止都还挺顺利的，现在开始引入etcd写测试代码，网上搜索了下教程，引入"github.com/coreos/etcd/clientv3"这个包就可以了。

package main

import (
	"context"
	"fmt"
	"github.com/coreos/etcd/clientv3"
)

func main() {
	cli, err := clientv3.New(clientv3.Config{
		Endpoints: []string{"10.1.30.79:12379"},
	})
	if err != nil {
		panic(err)
	}
	cli.Put(context.Background(), "/test-key", "test-value")
	rsp, err := cli.Get(context.Background(), "/test-key")
	if err != nil {
		panic(err)
	}
	fmt.Println(rsp.Kvs)
}

  踩坑开始，go mod tidy先下载依赖包，报错了
go: found github.com/golang/groupcache/lru in github.com/golang/groupcache v0.0.0-20210331224755-41bb18bfe9da
go: getcd imports
github.com/coreos/etcd/clientv3 tested by
github.com/coreos/etcd/clientv3.test imports
github.com/coreos/etcd/auth imports
github.com/coreos/etcd/mvcc/backend imports
github.com/coreos/bbolt: github.com/coreos/bbolt@v1.3.6: parsing go.mod:
module declares its path as: go.etcd.io/bbolt
but was required as: github.com/coreos/bbolt

  分析错误可能是 clientv3 依赖包 bbolt的问题，在 go.mod里替换下好了，在go.mod加入

replace github.com/coreos/bbolt v1.3.6 => go.etcd.io/bbolt v1.3.6

  ok，接着 go mod tidy，又报错
go: finding module for package google.golang.org/grpc/naming
getcd imports
github.com/coreos/etcd/clientv3 tested by
github.com/coreos/etcd/clientv3.test imports
github.com/coreos/etcd/integration imports
github.com/coreos/etcd/proxy/grpcproxy imports
google.golang.org/grpc/naming: module google.golang.org/grpc@latest found (v1.49.0), but does not contain package google.golang.org/grpc/naming

不清楚原因，去百度了说是grpc版本问题，要v1.26.0，再去replace下吧

replace google.golang.org/grpc => google.golang.org/grpc v1.26.0

  ok，这下解决了

四、寻找最优解

解决完问题，我寻思着这么大的开源项目不至于这样啊.
先去github上看一眼代码，切换到最新的release分支 release-3.5

这里看到有个 client 文件夹，点进去赫然看到了客户端代码

于是我更改包 github.com/coreos/etcd/clientv3 为 github.com/coreos/etcd/client/v3，删掉go.mod，重新 go tidy下
还是报错了

看到这里，我本来想修改 go.mod 替换 etcd 包，转念一想，不如直接用 go.etcd.io/etcd/client/v3，说干就干，来了

package main

import (
	"context"
	"fmt"
	"go.etcd.io/etcd/client/v3"
)

func main() {
	cli, err := clientv3.New(clientv3.Config{
		Endpoints: []string{"10.1.30.79:12379"},
	})
	if err != nil {
		panic(err)
	}
	cli.Put(context.Background(), "/test-key", "test-value")
	rsp, err := cli.Get(context.Background(), "/test-key")
	if err != nil {
		panic(err)
	}
	fmt.Println(rsp.Kvs)
}

然后直接试下，可以了，啥错没有！

五、结论

使用 go.etcd.io/etcd/client/v3 替换 github.com/coreos/etcd/clientv3