深入浅出深度了解springboot服务gateway网关

什么是服务网关

前文我们已经了解了构建微服务的基础springboot，同时也能使用springboot构建服务。接下来我们就基于springboot聊一下springcloud。这个springcloud并不是一个特定的技术，它指的是微服务中一个生态体系。比如包括网关，注册中心，配置中心等。今天我们就先了解一下微服务网关，微服务网关有很多种我们这次采用现在主流的spring cloud gateway来讲解说明。 在微服务体系中，每个服务都是一个独立的模块都是一个独立运行的组件，一个完整的微服务体系是由若干个独立的服务组成，每个服务完成自己业务模块功能。比如用户服务提供用户信息相关的服务和功能，支付模块提供支付相关的功能。各个服务之间通过REST API或者RPC（以后讲）进行通信，并且一般我们微服务要做到无状态的通信。 我们实现微服务之后在一些方面也会带来不方便的地方，如果网页端或者app端需要请求修改送货地址，还有购物之后要付款在这个场景下：

如上图会出现一些问题：

基于上面所以我们就需要一个中间层，让客户端去请求中间层，至于需要请求那个服务由中间件去请求，最后将结果汇总返回给客户端，这个中间层就是网关。

为什么要使用网关

使用网关有几个作用：

统一鉴权

一般我们在网关上进行鉴权有两种：1，是对于请求的客户端身份的认证。2，访问权限控制就是当确认用户身份之后判断是否有某个资源的访问权限。 曾经我们在单体应用中，客户端请求验证身份和对于资源权限的约束比较简单，通过请求的session就可以获取对应的用户以及权限信息，但是在微服务架构下，所有的服务都被拆成单个微服务而且还是集群部署这种情况就会变得复杂，因为如果还是使用session的话在分布式情况每次请求不一定会落在同一台机器上，这样就会导致session无效。就需要我们进行额外的工作保证集群中的session是一致的。所以我们在网关层进行统一的处理认证：

日志记录

当客户端请求进来之后我们需要记录当前请求的时间依赖来源地址，ip等信息，这样我们就可以统一的在网关层面上进行拦截获取，之后输出到日志文件中通过ELK组件进行输出，记录内容可以多维度多信息统一记录而不需要到具体每个服务中进行分别记录。

请求分发和过滤

对于网关来讲这个请求匹配分发是最重要的功能，我们常见的nginx其实他这个组件就有请求转发和过滤的功能，对于网关来讲可以对请求进行前置和后置的过滤。

灰度发布

一般公司的互联网产品都是迭代非常快的，基本都是小步快跑。基本是一个周发布一个版本迭代。在这种情况下就会出现风险，比如兼容性，功能完整度，时间比较短会存在bug最终产生事故等问题。这样一般我们发布的时候会将新的功能发布到指定的机器上分过去一小部分流量来观察具体情况。所以网关作为请求的入口就正好可以完成这个功能。

常用网关解决方案

一般我们常用的网关有几种比如：OpenResty、Zuul、Gateway、Kong、Tyk等。我们主要是用spring体系的框架，所以我们本文针对Gateway进行讲解，其它几种网关实现不做重点说明，OpenResty是有nginx+lua集成的web服务器，集成了许多三方库和模块。Zuul其实springcloud前期也是在集成使用，到那时由于他的线程模型策略可能导致的性能问题最终spring选择了自己研发的spring cloud gateway。

环境准备

本文我们使用一个简单的案例来演示一下spring cloud gateway的使用方法，首先我们需要住呢比2个spring boot的应用，具体创建方式请参考我们本专题第二篇文章。

我们根据以前专题创建了2个服务第一个服务我们添加一个controller

@RequestMapping(value = {"/getUser"}, method = RequestMethod.GET)
    public String getUser() {
        Map user = new HashMap<>();
        user.put("name", "张三");
        user.put("age", "45");
        String s = JSONObject.toJSONString(user);
        return s;
    }
复制代码

第二个网关服务我们增加pom依赖

        
            org.springframework.cloud
            spring-cloud-starter-gateway
            2.0.4.RELEASE
        
复制代码

在application.yml中添加gateway路由

spring:
  cloud:
    gateway:
      routes:
      - predicates:
            - Path =/gateway/**  #匹配规则
        uri: http://localhost:8099/getUser    #服务1的访问地址
        filters:
            - StripRrefix: 1 #去掉前缀
 server：
    port: 8077
复制代码

针对上面配置含义说明：

这个时候我们启动服务之后发现服务启动日志：Netty started on port(s): 8077.说明我们服务成功了，并且网关依赖的是nettyserver启动几个服务监听。 我们访问：

curl :8077/gateway/getUser

在配置正确的情况下将会返回服务返回的结果。

spring cloud gateway原理

上图是gateway官方给出的原理图，可能不太好理解，我们自己画个图辅助理解一下：

如上图有几个概念先说明一下：

当客户端发送请求到网关时，网关会根据一系列的Predicate的匹配结果来决定访问哪个route路由没有默认网关会产生什么问题，然后根据过滤器进行请求处理，过滤器可以在请求发送到后端服务之前和之后执行。

路由规则

spring cloud gateway中提供了路由匹配机制，比如我们前文配置的Path=/gateway/** . 意思就是通过Path的属性来匹配URL前缀是/gateway/的请求。其实spring cloud gateway给我们提供了很多规则供我们使用。 每一个Predicate的使用，你可以理解为：当满足这种条件后才会被转发，如果是多个，那就是都满足的情况下被转发。这些Predict的源码在org.springframework.cloud.gateway.handler.predicate包中我们简单看一下：

动态路由

gateway配置路由主要有两种方式，1.用yml配置文件，2.写在代码里。而无论是 yml，还是代码配置，启动网关后将无法修改路由配置，如有新服务要上线没有默认网关会产生什么问题，则需要先把网关下线，修改 yml 配置后，再重启网关。这种方式如果在网关上没有优雅停机就会出现服务间断，这无疑是不能被接受的。gateway网关启动时，路由信息默认会加载内存中，路由信息被封装到 RouteDefinition 对象中，配置多个RouteDefinition组成gateway的路由系统，RouteDefinition中的属性与上面代码配置的属性一一对应:

那么就需要我们的动态路由来解决这个问题了。Spring Cloud Gateway 提供了 Endpoint 端点，暴露路由信息，有获取所有路由、刷新路由、查看单个路由、删除路由等方法，具体实现类org.springframework.cloud.gateway.actuate.GatewayControllerEndpoint ，想访问端点中的方法需要添加 spring-boot-starter-actuator 注解，并在配置文件中暴露所有端点。编写动态路由实现类，需实现ApplicationEventPublisherAware接口。

/**
 * 动态路由服务
 */
@Service
public class GoRouteServiceImpl implements ApplicationEventPublisherAware {
    @Autowired
    private RouteDefinitionWriter routeDefinitionWriter;
    private ApplicationEventPublisher publisher;
    @Override
    public void setApplicationEventPublisher(ApplicationEventPublisher applicationEventPublisher) {
        this.publisher = applicationEventPublisher;
    }
    //增加路由
    public String add(RouteDefinition definition) {
        routeDefinitionWriter.save(Mono.just(definition)).subscribe();
        this.publisher.publishEvent(new RefreshRoutesEvent(this));
        return "success";
    }
    //更新路由
    public String update(RouteDefinition definition) {
        try {
            delete(definition.getId());
        } catch (Exception e) {
            return "update fail,not find route  routeId: "+definition.getId();
        }
        try {
            routeDefinitionWriter.save(Mono.just(definition)).subscribe();
            this.publisher.publishEvent(new RefreshRoutesEvent(this));
            return "success";
        } catch (Exception e) {
            return "update route  fail";
        }
    }
    //删除路由
    public Mono> delete(String id) {
        return this.routeDefinitionWriter.delete(Mono.just(id)).then(Mono.defer(() -> {
            return Mono.just(ResponseEntity.ok().build());
        })).onErrorResume((t) -> {
            return t instanceof NotFoundException;
        }, (t) -> {
            return Mono.just(ResponseEntity.notFound().build());
        });
    }
}
复制代码

编写 Rest接口，通过这些接口实现动态路由功能.

@RestController
@RequestMapping("/changeRoute")
public class ChangeRouteController {
    @Autowired
    private GoRouteServiceImpl goRouteServiceImpl;
    //增加路由
    @PostMapping("/add")
    public String add(@RequestBody GatewayRouteDefinition gwdefinition) {
        String flag = "fail";
        try {
            RouteDefinition definition = assembleRouteDefinition(gwdefinition);
            flag = this.goRouteService.add(definition);
        } catch (Exception e) {
            e.printStackTrace();
        }
        return flag;
    }
    //删除路由
    @DeleteMapping("/routes/{id}")
    public Mono> delete(@PathVariable String id) {
        try {
            return this.goRouteService.delete(id);
        }catch (Exception e){
            e.printStackTrace();
        }
        return null;
    }
    //更新路由
    @PostMapping("/update")
    public String update(@RequestBody GatewayRouteDefinition gwdefinition) {
        RouteDefinition definition = assembleRouteDefinition(gwdefinition);
        return this.goRouteService.update(definition);
    }
    //把传递进来的参数转换成路由对象
    private RouteDefinition assembleRouteDefinition(GatewayRouteDefinition gwdefinition) {
        RouteDefinition definition = new RouteDefinition();
        definition.setId(gwdefinition.getId());
        definition.setOrder(gwdefinition.getOrder());
        //设置断言
        List pdList=new ArrayList<>();
        List gatewayPredicateDefinitionList=gwdefinition.getPredicates();
        for (GatewayPredicateDefinition gpDefinition: gatewayPredicateDefinitionList) {
            PredicateDefinition predicate = new PredicateDefinition();
            predicate.setArgs(gpDefinition.getArgs());
            predicate.setName(gpDefinition.getName());
            pdList.add(predicate);
        }
        definition.setPredicates(pdList);
        //设置过滤器
        List filters = new ArrayList();
        List gatewayFilters = gwdefinition.getFilters();
        for(GatewayFilterDefinition filterDefinition : gatewayFilters){
            FilterDefinition filter = new FilterDefinition();
            filter.setName(filterDefinition.getName());
            filter.setArgs(filterDefinition.getArgs());
            filters.add(filter);
        }
        definition.setFilters(filters);
        URI uri = null;
        if(gwdefinition.getUri().startsWith("http")){
            uri = UriComponentsBuilder.fromHttpUrl(gwdefinition.getUri()).build().toUri();
        }else{
            // uri为 lb://consumer-service 时使用下面的方法
            uri = URI.create(gwdefinition.getUri());
        }
        definition.setUri(uri);
        return definition;
    }
}
复制代码

其实一般我们很少通过API去调用rest服务去增删路由信息，一般我们主流都是通过集成nacos的config功能动态增添路由。与nacos整合我们后面在讲。

过滤器

网关过滤器Filter分为Pre和Post即前置过滤和后置过滤器。分别为在具体请求转发到后端微服务之前执行和将结果返回给客户端之前执行。 内置的GatewayFilter比较多大概有19种，如：

就不过多举例了，使用起来也比较简单，我们着重看一下如何自定义过滤器：

全局过滤器：全局过滤器，对所有的路由都有效，所有不用在配置文件中配置，主要实现了GlobalFilter 和 Ordered接口，并将过滤器注册到spring 容器。

@Service
@Slf4j
public class AllDefineFilter implements GlobalFilter,Ordered{
    @Override
    public Mono filter(ServerWebExchange exchange, GatewayFilterChain chain) {
        log.info("[pre]-Enter AllDefineFilter");
        return chain.filter(exchange).then(Mono.fromRunnable(()->{
            log.info("[post]-Return Result");
        }));
    }
    @Override
    public int getOrder() {
        return 0;
    }
}
复制代码

局部过滤器：需要在配置文件中配置，如果配置，则该过滤器才会生效。主要实现GatewayFilter, Ordered接口，并通过AbstractGatewayFilterFactory的子类注册到spring容器中，当然也可以直接继承AbstractGatewayFilterFactory，在里面写过滤器逻辑，还可以从配置文件中读取外部数据。

@Component
@Slf4j
public class UserDefineGatewayFilter extends AbstractGatewayFilterFactory{
    public UserDefineGatewayFilter(){
        super(GpConfig.class);
    }
    @Override
    public GatewayFilter apply(GpConfig config) {
        return ((exchange, chain) -> {
            log.info("[Pre] Filter Request,name:"+config.getName());
            return chain.filter(exchange).then(Mono.fromRunnable(()->{
                log.info("[Post] Response Filter");
            }));
        });
    }
    public static class UserConfig{
        private String name;
        public String getName() {
            return name;
        }
        public void setName(String name) {
            this.name = name;
        }
    }
}
复制代码

这块需要有注意的地方：

其实整个spring cloud gateway 与spring cloud alibaba整合的很好，可以与nacos整合可以与sentinel整合进行限流，这个后期我们单独进行讲解。

看完三件事❤️

如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我三个小忙：

点赞，转发，有你们的 『点赞和评论』，才是我创造的动力。关注头条号 『 JAVA后端架构 』，不定期分享原创知识。同时可以期待后续文章ing关注作者后台私信【888】有惊喜相送