差之毫厘：etcd 3 完美支持 HTTP 访问？

最新推荐文章于 2025-03-25 10:52:03 发布

API7.ai 技术团队

最新推荐文章于 2025-03-25 10:52:03 发布

阅读量641

点赞数 1

本文链接：https://blog.csdn.net/ApacheAPISIX/article/details/119210358

版权

文章探讨了etcd 3.x版本从HTTP切换到gRPC后，通过gRPC-gateway支持HTTP访问的情况。作者指出，虽然有gRPC-gateway，但HTTP与gRPC仍存在细微差别，如MaxCallRecvMsgSize限制导致的大数据同步问题。etcd v3.5.0解决了此问题。此外，文章还提到在启用mTLS时，服务端证书用于客户端认证的错误情况，指出证书配置的注意事项。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

作者罗哲轩，Core developer of Apache APISIX

etcd 升级到 3.x 版本后，其对外 API 的协议从普通的 HTTP1 切换到了 gRPC。为了兼顾那些不能使用 gRPC 的特殊群体，etcd 通过 gRPC-gateway 的方式代理 HTTP1 请求，以 gRPC 形式去访问新的 gRPC API。（由于 HTTP1 念起来太过拗口，以下将之简化成 HTTP，正好和 gRPC 能够对应。请不要纠结 gRPC 也是 HTTP 请求的这种问题。）

Apache APISIX 开始用 etcd 的时候，用的是 etcd v2 的 API。从 Apache APISIX 2.0 版本起，我们把依赖的 etcd 版本升级到 3.x。由于 Lua 生态圈里面没有 gRPC 库，所以 etcd 对 HTTP 的兼容帮了我们很大的忙，这样就不用花很大心思去补这个短板了。

从去年 10 月发布 Apache APISIX 2.0 版本以来，现在已经过去了 8 个月。在实践过程中，我们也发现了 etcd 的 HTTP API 的一些跟 gRPC API 交互的问题。事实上，拥有 gRPC-gateway 并不意味着能够完美支持 HTTP 访问，这里还是有些细微的差别。