分布式架构-API网关

Posted 2023-05-05 飞翔在天

参考：https://developer.aliyun.com/article/1199004?utm_content=g_1000371169

阿里API网关帮助文档： https://help.aliyun.com/document_detail/177489.html

API网关核心能力

统一域名证书

鉴权：访问认证鉴权、JWT鉴权（Token）、第三方鉴权（用户配置自己的鉴权服务为API的访问进行鉴权，API网关在调用API后端服务之前先调用用户的鉴权服务，收到鉴权服务的鉴权成功应答后才会继续调用后端服务，否则给客户端返回鉴权失败的应答）

流控：通过多个维度对请求进行流控，可以对API，App（访问凭证），用户（访问方的App归属用户）三个维度进行秒、分钟、小时、天等时间维度进行流控，API网关同时提供针对请求中自定义参数这个维度的限流，请求的任意一个参数都可以成为流控的锚定值，比如用户可以指定请求中的IP头作为流控锚定值，那么可以通过API网关的流控能力轻松控制每个IP的请求RPS。

监控与报警：阿里云的API网关将所有业务访问日志同时同步到了阿里云的三个产品中：日志服务（SLS）、应用实时监控服务（ARMS）、云监控服务，用户可以在不同的云产品中通过不同的方式去观测与监视自己的业务监控情况。 

• 通过日志服务（SLS）查看每一个请求的详细情况，包括请求和应答、后端服务耗时等细节；
• 通过应用实时监控服务（ARMS）观测整个请求链条中，每个网络节点的耗时请求，对全链路耗时情况进行分析；
• 通过云监控服务，对所有业务日志进行监控，并可以根据业务情况针对后端应答码、后端服务耗时设置报警规则。

请求和应答大小限制

性能

赵毅 张涛：恒丰银行分布式核心系统-API网关技术的原型落地实践|恒银论坛

作者赵毅系恒丰银行科技开发部副总经理；张涛系恒丰银行科技开发部员工。

摘要

随着微服务架构的流行，以及服务拆分粒度的精细化，RPC、分布式事务、服务注册/发现、负载均衡、集群容错、服务治理、API网关等概念逐渐成为了构建微服务架构的基础组件。本文将结合恒丰银行分布式核心系统选型和原型验证过程中的实践经验，就API网关的形成背景、需求概述、技术架构、设计亮点等方面展开论述。本文曾发表于《中国金融电脑》2017年第4期，部分内容有所更新。

 

一、API网关建设的必要性

时至今日，很多银行出于系统、应用、数据等资源集中管理的目的，核心系统仍然采用单体式应用的部署和运行方式，并通过路由总控和应用总控进行交易接入、公共检查、安全控制、服务路由的管理。当然，很多银行也在逐步尝试分布式架构，但一般选择在核心系统以外的渠道系统或产品系统上，并通过ESB系统替代原先路由总控和应用总控的作用。

可以看到，我们今天谈到的API网关在定位上与前面提到的总控和ESB十分类似，都是做为后端服务暴露给外围应用的入口级服务而存在，以消除不同应用之间的技术差异，让不同的应用服务协调运作，实现了不同服务之间的通信与整合。但在功能上，API网关相对来说更注重稳定性和可用性，所以其在设计模式上更加轻量级，在保证接入安全有效、流量可控的前提下，专注于实现协议转换、报文适配、动态路由、异步通讯等基础功能。辅助用户简单、快速、低成本、低风险的实现微服务聚合、前后端分离、系统集成，有针对性的解决调用者与服务提供者之间错综复杂的调用关系，有助于加强后端服务API的管理。

二、API网关的功能设计

为了更好地设计适应银行业务的API网关产品，我们首先对业界现有的同类产品进行了调研，包括Zuul、Kong、Tyk三款。其中，Zuul主要面向Netflix公司自己使用，而Kong和Tyk更多是面向第三方付费企业，在功能上基本都以提供基础功能和扩展机制为主，主要包括安全认证、路由、流量控制、监控等。所以，可以看出，这三款产品的受众群体基本一致，以面向互联网企业为主，主要应对高并发和网络攻击，与银行做为金融行业的定位还是有所差异。

图1：同业功能调研

就金融行业而言，其API网关建设原则应首先着眼于立足行业自身特点，即在保证可用性、稳定性、扩展性的基础上，重点加强功能性、安全性、可维护性等方面的建设。

图2：我行API网关功能建设目标

如图2所示，恒丰银行API网关功能建设目标分为以下几点：

一是ARCHITECTURE（底层架构）。平台无关性，指基于自主研发的技术框架，不依赖其它第三方架构；插件机制，指框架支持良好的功能扩展机制，便于后期维护升级。

二是SERVICE/DATA MANAGE（服务/数据管理）。基于注册中心服务/配置发现，指通过类似于Zookeeper注册中心进行数据持久化，不依赖于数据库；订阅/通知机制，指通过注册中心的订阅/通知机制实现数据的及时更新；服务治理，一方面指通过业务数据的维护，控制请求流量及可访问的服务范围；另一方面指通过注册中心及时感知后端服务API的状态变化。

三是SECURITY CERTIFICATION（安全校验）。流量控制，指对请求流量进行控制的功能；权限控制，指对请求访问权限控制的功能；请求校验，指对请求信息的校验功能，一般为报文头中的公共信息；报文处理，指报文转换、解析等附加功能。

四是DYNAMIC ROUTING（动态路由）。多维度服务路由，指通过多种维度路由规则配置实现的服务识别能力；异步通讯，指通过异步通讯机制实现的高效交互能力；服务降级熔断，指通过服务隔离，实现自动化服务降级和断路的能力。

五是MONITOR（监控）。日志记录，指按照平台统一规范的日志记录行为；指标收集分析，指应用侧通过日志收集agent向流数据平台提供日志数据，并由流数据平台收集、加工、分析的过程；监控报警，指流数据平台根据监控规则甄别、输出报警信息的过程。

六是TODO（后续扩展）。旁路调用，指交易流程中需要外调其它系统，且交易结果不敏感、无需同步处理的部分，由API网关基于异步机制直接外调的场景；API生命周期管理，指实现后端服务API发布、测试、调试、下线、属性维护等全生命周期的管理。

三、API网关技术架构

在明确了功能清单后，还需进一步明确技术架构。首先是技术选型的过程，仍然是以Zuul、Kong、Tyk三个业界流行的框架做为依据。

图3：同业技术调研

如图3所示，Kong和Tyk使用的开发语言与我行现有的技术体系相距较大，存在一定的学习成本，以致于我们在这方面的技术储备存在不足，无法充分预估将会出现的问题和隐患；除此之外，Kong必须构建在Cassandra或PostgreSQL数据库上，而Tyk不支持SOAP格式，而Zuul凭借Netflix公司强大的技术背景，无论在开发语言、运行机制、配套产品等方面都更符合我行的特点和目标。所以，我行分布式核心系统API网关以其做为技术原型，基于Filter机制以及PRE-ROUTING-POST-ERROR 模型（PRPE 「前正后反」模型，如图4所示）实现，在框架层面为集成的标准化进行了铺垫，同时支持良好的扩展。

图4：filter-PRPE机制

在系统架构方面，如图5所示，API网关做为分布式技术框架中的一个组成部分，通过责任链机制（FilterChain）和JAVA SPI机制实现业务功能的插件化管理，并借助于注册中心模块（Registry）实现服务/配置信息的高效管理。

图5：系统架构

前面提到了我行API网关的建设要基于金融行业的特点，尤其注重功能性、安全性，主要体现在了功能部分提到的服务/配置管理、安全校验、动态路由几方面，而驱动和促使这些功能发挥预期效果的是与之相对应的数据结构设计。

图6：数据结构设计

如图6所示，网关涉及的数据主要包括基础配置信息、业务配置信息。其中，基础配置信息以文件的形式保存在本地，业务信息则通过注册中心进行订阅/通知，目前提供了基于Zookeeper的注册中心机制。具体来说，基础配置信息提供了网关启动所需的环境配置信息，包括注册中心配置、外调后端服务配置，以及默认的基础规则配置，包括IP黑白名单模式、报文头要素列表等，用来设定业务功能开关及校验键值对的键值。业务配置信息则提供了网关运行所需的业务规则配置，是通过管理端进行维护的，包括IP黑白名单配置、请求报文头配置、报文解析规则配置、路由规则配置，这些信息都是以键值对的形式存储，保证了模型的通用性、扩展性、可移植性；除此之外，还可以通过管理端动态维护基础规则配置，以覆盖配置文件中的默认值。

四、恒丰银行微服务API网关设计亮点

在介绍了整体技术架构后，下面将针对设计中的技术亮点进行逐一说明。

（一）平台无关性

API网关因其轻量级、功能独立、业务侵入低等特性，在设计时，我们便考虑以JAVA原生的机制实现，包括通过SPI机制实现filter及其它扩展点的扩展加载机制，以及基于第三方工具类实现的部分业务功能，例如基于StAX实现的xml报文向map格式的转换。除此之外，整个架构不依赖于其它第三方平台或框架，实现了平台无关性。如图7所示，展示了网关的内部逻辑。

图7：API网关内部逻辑图

（二）Filter-PRPE机制

基于Zuul的实现原理，我们在此之上进行了改良。首先，在网关启动时会依次调用每个filter的init方法，以通过注册中心获取运行期所需数据并缓存在内存中，以提高运行期效率；其次，接口类中定义了doPre和doPost方法，以实现filter的双向机制，即通过FilterChain按序依次执行完每个filter的doPre方法后，再反序执行重载了doPost的filter，其适用于在doPre中预留了资源，需要在doPost中释放的场景。如图8所示。

图8：Filter-PRPE实现

（三）服务/配置数据动态管理

区别于其它API网关依赖数据库进行数据持久化的做法，我们选择通过更为高效和去中心化的注册中心进行数据管理。初始业务数据是通过管理端进行的维护，在网关启动时便会订阅这些数据，以便数据的任何更改都会及时通知网关去更新缓存。如图9所示。

图9：服务/配置数据动态管理

（四）请求过滤机制

请求过滤机制属于filter中的PRE类别，其作用是对请求信息进行基础检查或处理，目前提供了报文转换、报文解析、黑白名单检查、请求参数校验功能，基于前面第3点提到的数据动态管理功能，每个功能都支持按需动态启/停，同时支持动态扩展。如图10所示。

图10：请求过滤机制

（五）多维度动态路由机制

路由机制属于filter中的ROUTING类别，也是所有filter中最为重要、核心的模块，其作用便是根据请求报文中的参数，将交易发送到与之匹配的后端服务，也是真正体现“网关”理念的模块。目前该模块提供了路由规则解析/检查、服务外调两个基础功能，其中，路由规则解析/检查通过图11所示的数据模型，实现了多维度的路由规则控制。

图11：路由规则模型

后端服务为增强其扩展性、部署灵活性，通过交易码（ConsumerId）、场景标识（Group）、版本号（Version）三个维度进行管理，而前端请求则可以根据业务需要灵活定制，在ConsumerId之外还可以增加渠道标识（ChannelId）、地区标识（AreaId）、客户信息标识（CustId）等，通过这两部分信息的规则映射，以实现请求权限控制、资源隔离、灰度路由、屏蔽降级等功能。如图12所示。

图12：多维度路由机制

（六）服务降级/熔断机制

分布式系统随着功能数量、访问规模的增加，即使在可以通过水平扩展提升性能的情况下，仍然会存在个别服务失效而引发的连锁反应，最终导致灾难性的整体性问题。

通过引入Netflix公司的Hystrix机制，通过资源隔离机制实现了如下目标：

一是防止单个依赖耗尽容器内所有用户线程；

二是降低系统负载，对无法及时处理的请求快速失败（failfast）而不是排队；

三是提供失败回退，以在必要时让失效对用户透明化；

四是使用隔离机制（例如“舱壁”/“泳道”模式、熔断器模式等）降低依赖服务对整个系统的影响。

任何新系统、新架构、新平台的尝试都不会是一帆风顺的，我们也只是在分布式微服务架构的建设之路上迈出了一小步，但正是这一点尝试，让我们切身感受到了微服务的魅力所在，也坚定了我们继续探索新知识的决心。