Zuul 2.1.5 设计分析

前言

zuul 是 SpringCloud 家族老兵，使用 Java 微服务大部分都在使用 zuul 作为网关。既然他如此重要，那么我们就来分析一下。本文分析的是 zuul 2.1.5版本。

调用链路

首先，我们知道，zuul 基于 Netty，Netty 是异步网络框架。我们从调用链路出发，分析下 Zuul 的调用链路是如何串起来的。

首先看官方介绍：

既然是基于 Netty 的，我们首先看 ChannelInboundHandler，Zuul 的 ChannelInboundHandler 名为 ClientRequestReceiver，用于接收 Http 请求。

然后，ClientRequestReceiver 会将请求交给 Zuul 的过滤器链，也就是我们经常编写的 Zuul 业务逻辑。Zuul 将整个过滤器链编织成一个 ZuulFilterChainHandler，作为 ClientRequestReceiver 的下一个 Handler。最后，当过滤器处理好逻辑并得到后端返回值，将 Response 交给 ClientResponseWriter，该类会将 Response 写回给客户端。代码如下：

好，我们知道了 Zuul 基于 Netty 是如何控制调用的，那么，我们再来看看，Zuul 是如何编织过滤器链的。代码就在 com.netflix.zuul.netty.server.BaseZuulChannelInitializer#addZuulFilterChainHandler 方法中。

从上面的截图，可以看到，Zuul 先是构造了 Response Filter Chain，然后再构造 Endpoint Chain，最后构造 Request Chain，形成了一张链表，并将起封装，添加到 Netty 的 pipeline 中。

Request Chain 作为头，Response Chain 作为尾，当 Response Chain 执行完之后，则会调用 ClientResponseWriter，将返回值写回 Http Client。

这里需要提一下 Endpoint Chain 概念，首先， Zuul 作为网关，核心职责是转发请求，而 endpoint 就是目标服务器，zuul 会将请求先经过 Request Chain，然后交给 Endpoint Chain，Endpoint Chain 则会请求后端服务器，拿到返回值，然后将返回值交给 Response Chain。

那么 Zuul 是如何请求后端服务的呢？

我们看 ZuulEndPointRunner 这个类，他是 Endpoint Chain 的标准实现。filter 方法是关键。

我们看到，这里有2个红框，第一个是获取过滤器，然后，执行过滤器逻辑，得到结果。从 getEndpoint 方法看，通常我们会得到 ProxyEndpoint 过滤器，他继承自 SyncZuulFilter。分支逻辑暂时不讲。

当得到 ProxyEndpoint 后，则会执行 apply 方法。

proxyRequestToOrigin 方法，背后是 Netty 客户端请求后端服务。该方法会先连接后端服务，然后在回调中，将 Request 内容发送给后端服务。注意，发送之前，会将此客户端的异步接收类 OriginResponseReceiver 添加到 pipeline 中，用于处理后端返回值。OriginResponseReceiver 得到返回值后，则会调用 ProxyEndpoint 的 responseFromOrigin 方法，该方法，则会将返回值交给 Response Chain。Response Chain 处理完之后，再交给 ClientResponseWriter，完成一次完整的调用。

整个调用图如下：

上图展示了一次请求的整个过程。

我们继续讨论下一个问题：Zuul 如何识别请求，并将其正确的转发的目标服务器？

假设，zuul ip port 为172.3.3.3:8080，后端服务为 172.2.2.2:8888，服务名为 userService，zuul

如何将请求转发到 172.2.2.2:8888？

首先需要定义规则，我们将服务名作为标识，通过服务名去 Eureka 找到服务地址，然后再进行调用。标识放在哪里？我们可以放在 URL 里面，比如 172.3.3.3:8080/userService/getUser 这个 url ，实际是请求的 172.2.2.2:8888/getUser 这个服务。当然，也可以将服务名放在 header 里。看自己的实现。

当 Zuul 拿到标识，则会请求 Eureka，拿到 ip 地址，构造一个 Netty 客户端，即 ProxyEndpoint 的 NettyOrigin 属性。当调用 connectToOrigin 方法后，会返回一个 Netty 的 promise，ProxyEndpoint 会将自己的调用逻辑放在回调中，即，NettyOrigin connect 成功后，ProxyEndpoint 会发送数据给后端服务器。

我们查看 com.netflix.zuul.netty.connectionpool.DefaultClientChannelManager#acquire 方法，该方法，会先调用 Server chosenServer = loadBalancer.chooseServer(key)，得到一个服务器ip port。然后得到一个 PerServerConnectionPool，

该类的 tryMakingNewConnection 方法，会构造一个 Netty 客户端。

至此，我们已经知道了 Zuul 整个的调用链路是如何实现的。

异步分析

Zuul 是如何基于 Netty 实现异步的呢？

首先入口 Handler 是 ClientRequestReceiver，当 ClientRequestReceiver 拿到请求后，会将 Request 交过过滤器链，而 Zuul 的过滤器是支持异步的。基于 RxJava 加入了 applyAsync 方法。

ProxyEndpoint 在请求后端服务时，也是异步的，ProxyEndpoint 的 apply 方法里，将自己的业务逻辑，放到了 zuul 客户端的回调里，这是基于 Netty 实现的。

流程图如下：

可以看到，Netty IO 线程，基本没有等待，从流量进来之后，要么在执行 Request chain 逻辑，要么在构建 Netty Client，没有任何等待 IO 的过程，当 Endpoint 在请求后端服务时，IO 线程是空闲的。而当后端返回时，会触发 Netty 客户端的回调，进而触发 Zuul Response 过滤器链，最后写回 ClientResponseWriter。

有个问题，异步返回时，是如何找到 ClientResponseWriter 的呢？Zuul 的实现方式是，将 ChannelHandlerContext 保存到 Session 里（_netty_server_channel_handler_context），当异步返回时，则会继续调用这个 ChannelHandlerContext 后面的 Handler 的 channelRead 方法。

Zuul 的 worker EventLoop grop 名为 Salamander-ClientToZuulWorker；

在构造请求后端服务的 Netty 客户端时，也是使用的该 EventLoop。如下图：