从 HTTP 到 gRPC：APISIX 中 etcd 操作的迁移之路

APISIX 从 HTTP 到 gRPC 操作 etcd 的迁移

最新推荐文章于 2025-09-01 16:05:41 发布

原创

最新推荐文章于 2025-09-01 16:05:41 发布 · 537 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#API 网关 #APISIX

Apache APISIX 在升级 etcd 到 3.x 后面临基于 HTTP 操作的局限性，包括默认未启用 gRPC-gateway、响应大小限制等。为解决问题，APISIX 决策迁移到 gRPC，克服了 lua-protobuf 的 bug、调整行为以匹配 HTTP、切换到长连接。迁移后，连接数显著减少，解决了 mTLS 等问题，提高了效率和稳定性。API7.ai 作为 APISIX 的主要支持者，持续推动其发展。

罗泽轩，API7.ai 技术专家/技术工程师，Apache APISIX PMC 成员。

原文链接

Apache APISIX 现有基于 HTTP 的 etcd 操作的局限性

etcd 在 2.x 版本的时候，对外暴露的是 HTTP 1 （以下简称 HTTP）的接口。etcd 升级到 3.x 版本后，其对外 API 的协议从普通的 HTTP 切换到了 gRPC。为了兼顾那些不能使用 gRPC 的特殊群体，etcd 通过 gRPC-gateway 的方式代理 HTTP 请求，以 gRPC 形式去访问新的 gRPC API。

APISIX 开始用 etcd 的时候，用的是 etcd v2 的 API。从 2020 年的 APISIX 2.0 版本起，我们把要求的 etcd 版本升级到 3.x。etcd 对 HTTP 的兼容帮了我们很大的忙，这样就不用花很大心思去重新实现操作 etcd 的方式了，只需调整下新的一组 API 的调用方式和响应处理。然而在实践过程中，我们也发现了跟 etcd 的 HTTP API 相关的一些问题。事实上，拥有 gRPC-gateway 并不意味着能够完美支持 HTTP 访问，这里还是有些细微的差别。

我把过去几年来在 etcd 上遇到的相关问题列了一下：