Spring Cloud gateway 路由规则
文章目录
- [Spring Cloud gateway 路由规则](#Spring Cloud gateway 路由规则)
-
- 一、路由常用属性解析
-
- [1.1 示例配置](#1.1 示例配置)
- [1.2 属性解析](#1.2 属性解析)
- 二、问题分析，springCloud微服务中没有任何路由配置，网关为什么能根据请求转发到相应的业务服务的
-
- [2.1 开启，用于启用通过服务发现来路由到服务的功能](#2.1 开启，用于启用通过服务发现来路由到服务的功能)
- [2.2 断点RoutePredicateHandlerMapping类查看自动注册的路由](#2.2 断点RoutePredicateHandlerMapping类查看自动注册的路由)
- [2.3 自动创建注册到Nacos的路由配置，包括dubbo服务](#2.3 自动创建注册到Nacos的路由配置，包括dubbo服务)
- [2.4 未开启 【spring: cloud: gateway: discovery: locator: enabled: false】](#2.4 未开启 【spring: cloud: gateway: discovery: locator: enabled: false】)
一、路由常用属性解析
1.1 示例配置
server:
port: 90
spring:
cloud:
gateway:
discovery:
locator:
enabled: true #启动DiscoveryClient,可以实现服务的发现,自动根据注册的服务创建对应的路由
routes:
- id: Auth
uri: lb://wuxsms-auth
order: -1
predicates:
- Path=/wuxsms-auth/**
filters:
- RewritePath=/wuxsms-auth/(?<segment>.*), /${segment}
- StripPrefix=21.2 属性解析
-
id：- 类型：字符串
- 作用：唯一标识一个路由。必须是唯一的，不能重复。
- 示例：
-
uri：- 类型：字符串
- 作用：指定目标微服务的 URI。可以是具体的 URL（http://www.baidu.com等第三方系统），也可以配合nacos服务注册中心负载均衡的 URI（如
lb://service-name）。
-
predicates：-
类型：列表
-
作用：定义一组断言，用于决定请求是否匹配该路由。每个断言都是一个条件，所有条件都满足时，请求才会被路由到目标微服务。
-
常见断言：
Path：匹配请求路径。Method：匹配请求方法（GET、POST 等）。Query：匹配查询参数。Header：匹配请求头。Cookie：匹配请求中的 Cookie。Host：匹配请求主机。
-
匹配规则
-
匹配规则
语法
示例
解释
精确匹配
Path=/exact/path
Path=/api/user
匹配请求路径为 /api/user 的请求
单级通配符
Path=/path/*
Path=/api/user/*
匹配 /api/user/ 下的一级子路径，例如 /api/user/profile
多级通配符
Path=/path/**
Path=/api/user/**
匹配 /api/user/ 下的所有子路径，包括多级子路径，例如 /api/user/profile 和 /api/user/orders/123
正则表达式
Path=/pattern
Path=/api/user/d+
匹配 /api/user/ 后跟一个或多个数字的路径，例如 /api/user/123
-
-
filters：-
类型：列表
-
作用：定义一组过滤器，用于在请求转发前后对请求或响应进行修改。过滤器可以改变请求路径、添加请求头等。
-
常见过滤器：
-
StripPrefix：去掉路径前缀。-
StripPrefix过滤器可以用来去掉路径中的前缀部分。这个过滤器更简单，适合去掉固定数量的路径段。例如：
spring: cloud: gateway: routes: - id: user-service uri: lb://user-service predicates: - Path=/api/user/** filters: - StripPrefix=2在这个配置中：
Path=/api/user/**表示匹配以/api/user/开头的路径。StripPrefix=2表示去掉路径中的前两个段，即/api和user。
-
-
RewritePath：重写请求路径。 -
springCloud 中网关自动转发到其他服务就是使用改属性的配置
-
AddResponseHeader：添加响应头。 -
SetStatus：设置响应状态码。 -
Retry：重试机制。
-
-
-
order：- 类型：整数
- 作用：定义路由的优先级。顺序值越小，优先级越高。默认情况下，路由是按配置顺序依次匹配的，只要匹配到就不再往下匹配。
-
metadata：- 类型：键值对
- 作用：存储额外的元数据信息，可以在过滤器或其他组件中使用。
二、问题分析，springCloud微服务中没有任何路由配置，网关为什么能根据请求转发到相应的业务服务的
2.1 开启，用于启用通过服务发现来路由到服务的功能
spring:
cloud:
gateway:
discovery:
locator:
enabled: true2.2 断点RoutePredicateHandlerMapping类查看自动注册的路由
发现有两条【lb://wuxsms-auth】服务的路由配置
为什么会有两条呢？
- 第一条：nacos配置中心自定义配置的一条
- 第二条：配置【spring: cloud: gateway: discovery: locator: enabled: true】是自动创建的一条
第一条：
第二条：
2.3 自动创建注册到Nacos的路由配置，包括dubbo服务
onNext(Route{id='ReactiveCompositeDiscoveryClient_wuxsms-auth', uri=lb://wuxsms-auth, order=0, predicate=Paths: [/wuxsms-auth/**], match trailing slash: true, gatewayFilters=[[[RewritePath /wuxsms-auth/(?<remaining>.*) = '/${remaining}'], order = 1]], metadata={nacos.instanceId=192.168.1.111#8889#DEFAULT#DEFAULT_GROUP@@wuxsms-auth, nacos.weight=1.0, nacos.cluster=DEFAULT, nacos.healthy=true, dubbo.metadata-service.urls=[ "dubbo://192.168.1.111:20880/com.alibaba.cloud.dubbo.service.DubboMetadataService?anyhost=true&application=wuxsms-auth&bind.ip=192.168.1.111&bind.port=20880&deprecated=false&dubbo=2.0.2&dynamic=true&generic=false&group=wuxsms-auth&interface=com.alibaba.cloud.dubbo.service.DubboMetadataService&methods=getAllServiceKeys,getServiceRestMetadata,getExportedURLs,getAllExportedURLs&pid=1540&qos.enable=false&release=2.7.4.1&revision=2.2.0.RELEASE&side=provider&threads=500&timeout=6000×tamp=1731655720770&version=1.0.0" ], preserved.register.source=SPRING_CLOUD}})- predicate: /wuxsms-auth/**，配置服务名称开头的路由
- RewritePath : /wuxsms-auth/(.*), /${segment} 去掉服务前缀后再转发到相应的服务
- order：0 ，小于nacos配置中心的优先级
- match trailing slash：true 匹配尾部斜杠
- Metadata: 元数据 （存储额外的元数据信息，可以在过滤器或其他组件中使用)
2.4 未开启 【spring: cloud: gateway: discovery: locator: enabled: false】
不开启该配置，则需要手动配置路由规则。若两者都没有配置则系统无法正常访问