Spring Cloud构建微服务架构:服务网关(路由配置)【Dalston版】

简介:

在上一篇《Spring Cloud构建微服务架构:服务网关(基础)》一文中,我们通过使用Spring Cloud Zuul构建了一个基础的API网关服务,同时也演示了Spring Cloud Zuul基于服务的自动路由功能。在本文中,我们将进一步详细地介绍关于Spring Cloud Zuul的路由功能,以帮助读者可以更好的理解和使用它,以完成更复杂的路由配置。

Spring Cloud构建微服务架构:服务网关(路由配置)【Dalston版】

传统路由配置

所谓的传统路由配置方式就是在不依赖于服务发现机制的情况下,通过在配置文件中具体指定每个路由表达式与服务实例的映射关系来实现API网关对外部请求的路由。

没有Eureka和Consul的服务治理框架帮助的时候,我们需要根据服务实例的数量采用不同方式的配置来实现路由规则:

(1) 单实例配置:通过一组 zuul.routes. .path与 zuul.routes. .url参数对的方式配置,比如:


 
 
  1. zuul.routes.user-service.path=/user-service/** 
  2. zuul.routes.user-service.url=http://localhost:8080/ 

该配置实现了对符合 /user-service/**规则的请求路径转发到http://localhost:8080/地址的路由规则,比如,当有一个请求 http://localhost:1101/user-service/hello被发送到API网关上,由于 /user-service/hello能够被上述配置的 path规则匹配,所以API网关会转发请求到 http://localhost:8080/hello地址。

(2) 多实例配置:通过一组 zuul.routes. .path与 zuul.routes. .serviceId参数对的方式配置,比如:


 
 
  1. zuul.routes.user-service.path=/user-service/** 
  2. zuul.routes.user-service.serviceId=user-service 
  3.  
  4. ribbon.eureka.enabled=false 
  5. user-service.ribbon.listOfServers=http://localhost:8080/,http://localhost:8081/ 

该配置实现了对符合 /user-service/**规则的请求路径转发到http://localhost:8080/和 http://localhost:8081/两个实例地址的路由规则。它的配置方式与服务路由的配置方式一样,都采用了 zuul.routes. .path与 zuul.routes. .serviceId参数对的映射方式,只是这里的 serviceId是由用户手工命名的服务名称,配合  .ribbon.listOfServers参数实现服务与实例的维护。

由于存在多个实例,API网关在进行路由转发时需要实现负载均衡策略,于是这里还需要Spring Cloud Ribbon的配合。由于在Spring Cloud Zuul中自带了对Ribbon的依赖,所以我们只需要做一些配置即可,比如上面示例中关于Ribbon的各个配置,它们的具体作用如下:

  • ribbon.eureka.enabled:由于 zuul.routes. .serviceId指定的是服务名称,默认情况下Ribbon会根据服务发现机制来获取配置服务名对应的实例清单。但是,该示例并没有整合类似Eureka之类的服务治理框架,所以需要将该参数设置为false,不然配置的 serviceId是获取不到对应实例清单的。
  • user-service.ribbon.listOfServers:该参数内容与 zuul.routes. .serviceId的配置相对应,开头的 user-service对应了 serviceId的值,这两个参数的配置相当于在该应用内部手工维护了服务与实例的对应关系。

不论是单实例还是多实例的配置方式,我们都需要为每一对映射关系指定一个名称,也就是上面配置中的  ,每一个  就对应了一条路由规则。每条路由规则都需要通过 path属性来定义一个用来匹配客户端请求的路径表达式,并通过 url或 serviceId属性来指定请求表达式映射具体实例地址或服务名。

服务路由配置

服务路由我们在上一篇中也已经有过基础的介绍和体验,Spring Cloud Zuul通过与Spring Cloud Eureka的整合,实现了对服务实例的自动化维护,所以在使用服务路由配置的时候,我们不需要向传统路由配置方式那样为 serviceId去指定具体的服务实例地址,只需要通过一组 zuul.routes. .path与 zuul.routes. .serviceId参数对的方式配置即可。

比如下面的示例,它实现了对符合 /user-service/**规则的请求路径转发到名为 user-service的服务实例上去的路由规则。其中  可以指定为任意的路由名称。


 
 
  1. zuul.routes.user-service.path=/user-service/** 
  2. zuul.routes.user-service.serviceId=user-service 

对于面向服务的路由配置,除了使用 path与 serviceId映射的配置方式之外,还有一种更简洁的配置方式: zuul.routes. =  ,其中  用来指定路由的具体服务名,  用来配置匹配的请求表达式。比如下面的例子,它的路由规则等价于上面通过 path与 serviceId组合使用的配置方式。


 
 
  1. zuul.routes.user-service=/user-service/** 

传统路由的映射方式比较直观且容易理解,API网关直接根据请求的URL路径找到最匹配的 path表达式,直接转发给该表达式对应的 url或对应 serviceId下配置的实例地址,以实现外部请求的路由。那么当采用 path与 serviceId以服务路由方式实现时候,没有配置任何实例地址的情况下,外部请求经过API网关的时候,它是如何被解析并转发到服务具体实例的呢?

在Spring Cloud Netflix中,Zuul巧妙的整合了Eureka来实现面向服务的路由。实际上,我们可以直接将API网关也看做是Eureka服务治理下的一个普通微服务应用。它除了会将自己注册到Eureka服务注册中心上之外,也会从注册中心获取所有服务以及它们的实例清单。

所以,在Eureka的帮助下,API网关服务本身就已经维护了系统中所有serviceId与实例地址的映射关系。当有外部请求到达API网关的时候,根据请求的URL路径找到最佳匹配的 path规则,API网关就可以知道要将该请求路由到哪个具体的 serviceId上去。由于在API网关中已经知道 serviceId对应服务实例的地址清单,那么只需要通过Ribbon的负载均衡策略,直接在这些清单中选择一个具体的实例进行转发就能完成路由工作了。

示例仓库

  • Github:https://github.com/dyc87112/SpringCloud-Learning
  • 码云:https://gitee.com/didispace/SpringCloud-Learning/

本文作者: 翟永超
来源:51CTO
相关文章
|
API 微服务
阿里云微服务引擎 MSE 及 API 网关 2025 年 9 月产品动态
阿里云微服务引擎 MSE 及 API 网关 2025 年 9 月产品动态。
1168 79
|
监控 Cloud Native Java
Spring Boot 3.x 微服务架构实战指南
🌟蒋星熠Jaxonic,技术宇宙中的星际旅人。深耕Spring Boot 3.x与微服务架构,探索云原生、性能优化与高可用系统设计。以代码为笔,在二进制星河中谱写极客诗篇。关注我,共赴技术星辰大海!(238字)
1606 2
Spring Boot 3.x 微服务架构实战指南
|
运维 Cloud Native 应用服务中间件
阿里云微服务引擎 MSE 及 API 网关 2025 年 9 月产品动态
阿里云微服务引擎 MSE 面向业界主流开源微服务项目, 提供注册配置中心和分布式协调(原生支持 Nacos/ZooKeeper/Eureka )、云原生网关(原生支持Higress/Nginx/Envoy,遵循Ingress标准)、微服务治理(原生支持 Spring Cloud/Dubbo/Sentinel,遵循 OpenSergo 服务治理规范)能力。API 网关 (API Gateway),提供 APl 托管服务,覆盖设计、开发、测试、发布、售卖、运维监测、安全管控、下线等 API 生命周期阶段。帮助您快速构建以 API 为核心的系统架构.满足新技术引入、系统集成、业务中台等诸多场景需要。
787 142
|
Java 数据库 数据安全/隐私保护
Spring Boot四层架构深度解析
本文详解Spring Boot四层架构(Controller-Service-DAO-Database)的核心思想与实战应用,涵盖职责划分、代码结构、依赖注入、事务管理及常见问题解决方案,助力构建高内聚、低耦合的企业级应用。
2056 1
API 微服务
401 0
|
Kubernetes Java 微服务
Spring Cloud 微服务架构技术解析与实践指南
本文档全面介绍 Spring Cloud 微服务架构的核心组件、设计理念和实现方案。作为构建分布式系统的综合工具箱,Spring Cloud 为微服务架构提供了服务发现、配置管理、负载均衡、熔断器等关键功能的标准化实现。本文将深入探讨其核心组件的工作原理、集成方式以及在实际项目中的最佳实践,帮助开发者构建高可用、可扩展的分布式系统。
1022 0
|
运维 Cloud Native 应用服务中间件
阿里云微服务引擎 MSE 及 API 网关 2025 年 8 月产品动态
阿里云微服务引擎 MSE 面向业界主流开源微服务项目, 提供注册配置中心和分布式协调(原生支持 Nacos/ZooKeeper/Eureka )、云原生网关(原生支持Higress/Nginx/Envoy,遵循Ingress标准)、微服务治理(原生支持 Spring Cloud/Dubbo/Sentinel,遵循 OpenSergo 服务治理规范)能力。API 网关 (API Gateway),提供 APl 托管服务,覆盖设计、开发、测试、发布、售卖、运维监测、安全管控、下线等 API 生命周期阶段。帮助您快速构建以 API 为核心的系统架构.满足新技术引入、系统集成、业务中台等诸多场景需要。
717 152
|
Cloud Native Serverless API
微服务架构实战指南:从单体应用到云原生的蜕变之路
🌟蒋星熠Jaxonic,代码为舟的星际旅人。深耕微服务架构,擅以DDD拆分服务、构建高可用通信与治理体系。分享从单体到云原生的实战经验,探索技术演进的无限可能。
1091 4
微服务架构实战指南:从单体应用到云原生的蜕变之路
|
缓存 Cloud Native Java
Java 面试微服务架构与云原生技术实操内容及核心考点梳理 Java 面试
本内容涵盖Java面试核心技术实操,包括微服务架构(Spring Cloud Alibaba)、响应式编程(WebFlux)、容器化(Docker+K8s)、函数式编程、多级缓存、分库分表、链路追踪(Skywalking)等大厂高频考点,助你系统提升面试能力。
1842 0