大家好，我是煎鱼。

前几年非常高频的接触到这一堆微服务相关组件：grpc + grpc-gateway + etcd + protobuf + protoc-gen-go，一开始都是相安无事，逐步跟进新版本。

这不，幺蛾子就来了。写这些组件的开发大佬（或公司）都不在一起，各自为政，各有各的想法、喜欢、规范...因此会出互相不兼容，甚至出现了卡脖子的情况。

图片

各种兼容问题

当 etcd 是 v3.3/v3.4，grpc > v1.27 时，经常会遇到各种看着脑壳痛的兼容性问题。

至少但不限于如下几个场景。只是例举几个比较常见的三个兼容错误。

找不到 grpc/naming

找不到 grpc-go 库中的google.golang.org/grpc/naming 包。原因是什么？原因之一是 go.etcd.io/etcd/client 引用到 grpc-go 库中的实验包。

在 go mod tidy 时，会遇到如下报错：

go: finding module for package google.golang.org/grpc/naming
go: finding module for package google.golang.org/grpc/examples/helloworld/helloworld
go: found google.golang.org/grpc/examples/helloworld/helloworld in google.golang.org/grpc/examples v0.0.0-20231026203026-8cb98464e599
go: finding module for package google.golang.org/grpc/naming
go: git.xxx.cn/xxx/xxx-common/jy imports
 go.etcd.io/etcd/client tested by
 go.etcd.io/etcd/client.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.59.0), but does not contain package google.golang.org/grpc/naming

看到最后的 but does not contain package google.golang.org/grpc/naming。以为是 grpc-go 乱删库，做了不兼容变更。

想着找官方解决一下问题。印象很深刻，人家 grpc-go 表示：我这库早就声明了是实验性，随时可能删除，你不应该依赖他。（不会支持的意思）

找不到 etcd/clientv3/balancer/picker

还是由于 grpc-go 库的实验包在新版本去掉了。会导致 etcd v3.3 出现：undefined: balancer.PickOptions 和 undefined: resolver.BuildOption 的相关错误信息：

$ go get go.etcd.io/etcd/clientv3
# github.com/coreos/etcd/clientv3/balancer/resolver/endpoint
../../go/pkg/mod/github.com/coreos/etcd@v3.3.18+incompatible/clientv3/balancer/resolver/endpoint/endpoint.go:114:78: undefined: resolver.BuildOption
../../go/pkg/mod/github.com/coreos/etcd@v3.3.18+incompatible/clientv3/balancer/resolver/endpoint/endpoint.go:182:31: undefined: resolver.ResolveNowOption
# github.com/coreos/etcd/clientv3/balancer/picker
../../go/pkg/mod/github.com/coreos/etcd@v3.3.18+incompatible/clientv3/balancer/picker/err.go:37:44: undefined: balancer.PickOptions
../../go/pkg/mod/github.com/coreos/etcd@v3.3.18+incompatible/clientv3/balancer/picker/roundrobin_balanced.go:55:54: undefined: balancer.PickOptions

不得不说，这个 BUG 我还给 etcd 提了 issues 和 pr：

图片

最终合并了。（但是 etcd v3.5 当年发布的太慢了，没等到...）

找不到 grpc.SupportPackageIsVersion6

protoc-gen-go 与 grpc 版本不兼容。会出现如下报错：

Getting error undefined: grpc.SupportPackageIsVersion6 and undefined: grpc.ClientConnInterface

本身这个问题，只需要升级 grpc >= 1.27 就可以了。但如果你使用了 etcd sdk，又会前面的 etcd 版本依赖问题，程序会陷入麻烦的升又升不得，降也降不了。

最后还是将 protoc(protoc-gen-go) 降级为 v1.3.2，grpc 保持在 v1.26，这样 etcd v3.3 的依赖才能正常使用。

背后缘由

细心的同学会发现，归根到底还是和 etcd v3.3 扯上关系，grpc 就没法升级到 v1.27 以上。其他所有关联的 protoc、grpc-gateway 的版本都没法继续推进。

当你想用 go module 来做各种兼容管理时，会发现 etcd v3.3 根本没有 go module...

etcd v3.4 虽然有 go.mod，但也无法拉取和使用（原因详见：etcd-io/etcd/issues/11154[1]）。

图片

etcd 官方的响应也是不太积极的。猜测是积重难返，比较难解决。

解决方案

社区等了许多年，现在终于有了解决办法。etcd v3.5 已经正式支持了 go module！

etcd 将之前的模块按功能做了领域划分，把之前各种的低版本依赖、循环依赖等问题都处理了。

如下图所示：

图片

图片

拆分为了 api、client、raft、server、etcdctl、bbolt 等独立的 Go 模块。不会像老版本一样交叉影响。

如果你是新项目，建议无脑使用 etcd v3.5 以上版本。千万别用 v3.3/v3.4 及更低的！

比较无奈的一点

可能有的同学以为皆大欢喜了？其实并不。

他的模块化改造成功仅限于 etcd v3.5 的版本。而历史项目，如果你是使用 etcd v2 store，那么很抱歉。

etcd 老版本（v3.3/v3.4 等）是没有变动的，在 v3.5 的新版本（包含最新的文档）中都在开始在逐步去除 etcd v2 的相关支持。

图片

如果仍然在使用 etcd v2 的同学，建议进行数据迁移用 v3。这样可以避免很多技术上的问题。

迁移不方便的话，除了各种 replace 和锁版本外。如果你使用的 etcd 功能非常基础，也可以自己实现一个简易版的 SDK。

总结

etcd 的这个历史问题已经存在了好几年，一直处理的慢慢吞吞。甚至影响到了 Go 生态圈的一些技术选型问题。

前几天有同学反馈 tidb 里引用了 cloud.google.com/go/pubsub 库，而该库又依赖了 grpc 的较高的版本。从而导致原有卡在 grpc v1.26 的应用又出现了问题。才回过头来看看。

在新版本中，etcd 的依赖问题终于解决了。真的是，这值得被我们记住！虽然他老版本依然没处理...