Spring Cloud Gateway 路由表配置

Spring Cloud Gateway 的路由表是网关的核心配置,负责将请求转发到不同的服务 / 地址。以下是基于示例配置的关键解析:

一、基础结构

路由表配置在spring.cloud.gateway.routes下,每个路由是一个独立的配置项,包含以下核心字段:

复制代码
spring:
  cloud:
    gateway:
      routes:
        - id: 路由唯一标识  # 每个路由必须有唯一id
          uri: 目标地址       # 请求要转发到的地址
          predicates: []      # 路由匹配规则(满足条件才转发)
          filters: []         # 路由过滤器(转发前后的加工逻辑)
          order: 优先级数字   # 数字越小,优先级越高

二、示例配置拆解

以示例中的两个路由为例,解析不同场景的配置逻辑:

1. 转发到外部地址(bing-route)

复制代码
- id: bing-route  # 路由id:bing-route
  uri: https://cn.bing.com/  # 目标地址:必应官网(外部地址)
  predicates:
    - Path=/**  # 匹配规则:所有路径(任意请求都能匹配)
  filters: []   # 无过滤器
  order: 10     # 优先级:10(数字大,优先级低)
  metadata:     # 自定义元数据(非核心,可用于扩展逻辑)
    hello: world
  • 作用:所有请求都会被转发到必应官网;
  • 注意:uri填外部地址时,直接写完整的 HTTP/HTTPS 地址。

2. 转发到微服务(order-route)

复制代码
- id: order-route  # 路由id:order-route
  uri: lb://service-order  # 目标地址:微服务service-order(lb=负载均衡)
  predicates:
    - Path=/api/order/**  # 匹配规则:以/api/order/开头的路径
  order: 1  # 优先级:1(数字小,优先级高)
  • 作用:只有路径以/api/order/开头的请求,才会转发到service-order微服务;
  • 关键:uri: lb://服务名是微服务场景的写法,lb表示开启负载均衡(需配合 Nacos/Eureka 等注册中心)。

三、核心字段说明

|--------------|------------------------------------------------|
| 字段名 | 作用 |
| id | 路由唯一标识,不能重复 |
| uri | 转发目标:- 外部地址:https://xxx.com - 微服务:lb://服务名 |
| predicates | 路由匹配规则(多个规则需同时满足),常用Path=/xxx/** (路径匹配) |
| filters | 过滤器(如添加请求头、路径重写等),空数组表示无过滤 |
| order | 路由优先级:数字越小,优先级越高(多个路由匹配时,优先走 order 小的) |

四、优先级注意事项

示例中order-routeorder=1bing-routeorder=10

  • 当请求路径是/api/order/xxx时,会先匹配order-route(因为优先级更高),转发到service-order
  • order-routeorder大于bing-route,则/api/order/xxx会被bing-route拦截,转发到必应(不符合预期)。→ 匹配更精确的路由, order****要设置更小的数字
相关推荐
William Dawson7 小时前
2026软考中级系统集成项目管理工程师备考笔记
笔记·系统集成项目管理工程师
love530love10 小时前
精简版|Claude-HUD 插件介绍 + 一键安装教程
人工智能·windows·笔记
想成为优秀工程师的爸爸11 小时前
第三十篇技术笔记:郭大侠学UDS - 人有生老三千疾,望闻问切良方医
网络·笔记·网络协议·tcp/ip·信息与通信
tq108612 小时前
数学:约束表征空间的最小闭包
笔记
freexyn13 小时前
Matlab自学笔记七十六:表达式的展开、因式分解、化简、合并同类项
笔记·算法·matlab
IT摆渡者15 小时前
linux 系统安全检查
运维·网络·经验分享·笔记
十安_数学好题速析17 小时前
【多选】曲线方程:四步避坑判断曲线类型
笔记·学习·高考
chase。19 小时前
【学习笔记】skrl: 模块化、灵活的强化学习库深度解析
笔记·学习
其实防守也摸鱼19 小时前
CSDN博客写什么?从0到1打造你的技术影响力
笔记·测试用例·博客·教程·ai写作·ai辅助·高质量
EQ-雪梨蛋花汤19 小时前
【Unity笔记】Unity 音游模板与免费资源:高效构建节奏游戏开发全指南
笔记·unity·游戏引擎