《微服务架构设计模式》 第八章读书笔记：外部API模式

标签微服务API网关API GatewayBFFSpring Cloud GatewayGraphQL一句话微服务拆分后不能直接对外暴露细粒度服务接口API Gateway/BFF 作为统一入口解决多客户端、网络差异、协议转换、多服务数据聚合问题。前言单体应用对外只提供一套API。拆分为微服务之后每个服务独立提供API如果让移动端、浏览器JS、第三方应用直接调用后端微服务会带来大量工程问题。本章核心就是外部API设计难题以及两种核心模式API Gateway、后端前置模式BFFBackend For Frontend同时介绍两种落地实现方案Spring Cloud Gateway响应式网关、GraphQL网关。案例FTGO外卖应用订单详情分散在Order、Kitchen、Delivery、Accounting多个服务。单体一次请求拿到全部订单信息微服务架构下客户端直接调用需要串行/并行发起4次网络请求。一、微服务直接暴露给客户端的三大痛点1. 网络性能差用户体验糟糕移动端/公网网络延迟远高于内网局域网。客户端多次请求串行调用延迟叠加页面卡顿并行调用依然多次往返消耗移动设备电量前端要写复杂的多接口聚合逻辑前端重心偏离UI交互。2. 封装丢失服务与客户端强耦合客户端感知后端服务拆分、接口定义。后端服务一旦改接口、拆分服务移动端App需要发版还要等待应用商店审核用户不一定升级第三方API更是需要长期兼容旧版本变更成本极高。3. 协议不统一防火墙穿透困难后端微服务内部可能使用gRPC、AMQP等协议。公网客户端只适合HTTP/WebSocket直接暴露内部协议无法穿透防火墙。补充内网Web应用防火墙内可以直接调用后端服务因为低延迟、同团队迭代所以不是所有客户端都必须走网关。二、API Gateway 模式核心模式定义API Gateway是微服务体系对外的统一入口类似外观模式Facade封装后端微服务内部架构面向外部客户端提供定制API。API Gateway 四大核心能力请求路由反向代理匹配路径/HTTP方法转发到对应后端服务类似Nginx。API聚合API组合网关内部并行调用多个微服务把多个服务结果合并客户端只需要一次请求FTGO订单详情场景。协议转换对外HTTP对内gRPC等屏蔽内部通信协议。边缘公共能力鉴权、限流、熔断、日志、监控、TLS终止、请求缓存。API Gateway两种架构选型单一API Gateway所有客户端共用同一个网关一套代码维护。缺点不同客户端移动端、桌面Web、第三方数据需求不一样容易膨胀团队冲突。后端前置模式 BFFBackend For Frontend为每一类客户端单独部署独立网关。优势各前端团队独立维护自己的网关可以自主迭代、发布互不影响。适用移动端、管理后台Web、用户Web端各自独立BFF。现代工程实践BFF模式现在广泛用于前后端分离项目前端团队拥有自己的BFF服务做数据裁剪、聚合不再让后端主网关承担所有客户端适配工作。三、API Gateway落地实现方案方案1Spring Cloud GatewayJava响应式网关书中示例使用Spring Cloud Gateway WebFlux Project Reactor。底层响应式非阻塞Mono/Flux高并发资源开销小。两种路由规则简单代理路由路径匹配直接转发到后端微服务自定义Handler拦截请求在网关内编写API聚合逻辑并行调用多个服务组装返回结果。代码要点Configuration RouterFunction 定义路由DSLWebClient响应式HTTP客户端调用后端服务Mono.when()并行聚合多个服务调用结果onErrorReturn容错部分非核心服务失败返回空对象保证整体接口可用。现代扩展现在云原生环境除了Spring Cloud Gateway还有APISIX、Kong、EnvoyIstio网关性能更强适合K8s集群Spring Cloud Gateway更适合Spring技术栈自建网关。方案2GraphQL 实现API GatewayREST网关痛点不同客户端返回字段不一样要维护大量接口/扩展参数开发量大。GraphQL解决客户端按需获取字段。Schema定义对象模型Order、Consumer、Restaurant、字段、对象关系Resolver解析器每个字段绑定解析函数调用后端微服务查询客户端单次请求精确指定需要哪些字段不会出现过度获取over-fetching。GraphQL性能优化重点问题简单实现会产生N1查询问题例如查询N个订单循环N次调用餐馆服务解决方案DataLoader批处理 缓存合并同一轮事件循环内相同ID的请求减少后端调用次数。现代技术补充Apollo Federation把GraphQL Schema拆分到各个微服务实现分布式GraphQL网关现在很多大厂使用GraphQL适合移动端、复杂前端但公开第三方APIREST依然是首选缓存简单、调试方便。四、方案选型对比方案优势缺点适合场景自建Spring Cloud GatewayJava栈友好自定义聚合逻辑灵活响应式高性能需要自己维护代码、处理熔断容错Spring微服务需要定制业务聚合逻辑GraphQL网关客户端按需取字段一套Schema适配多端学习成本高N1问题需要DataLoaderHTTP缓存弱多端移动端Web页面需要灵活组合异构数据商用/开源网关(Kong/APISIX)开箱即用限流鉴权云原生高性能业务聚合能力弱复杂API聚合需要BFF配合只需要路由、鉴权业务聚合逻辑简单五、本章核心总结 工程落地建议不要直接把细粒度微服务暴露给公网客户端会产生网络、耦合、协议三类问题API Gateway核心价值入口收敛、协议转换、多服务数据聚合、边缘安全能力BFF后端前置是API Gateway的变种多客户端场景优先考虑BFF团队解耦现在主流前端架构都在用API聚合逻辑两种写法Spring Cloud Gateway响应式Handler / GraphQL Resolver边界思考网关适合做数据聚合、裁剪、安全不要把复杂业务逻辑写在网关网关太重会成为新的单体。延伸思考2026云原生视角 现在很多项目把纯网关能力路由、限流交给Envoy/APISIX业务聚合逻辑下沉到BFF服务网关只做流量入口BFF做数据组装分层架构职责更清晰。