SpringCloud Gateway路由表配置实现小结

 更新时间:2026年01月14日 08:59:55   作者:南屿欣风  
SpringCloudGateway通过路由表将请求转发到不同的服务或地址,每个路由包含id、uri、predicates和filters等字段,下面就来介绍一下SpringCloud 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-route的order=1,bing-route的order=10:

  • 当请求路径是/api/order/xxx时,会先匹配order-route(因为优先级更高),转发到service-order;
  • 若order-route的order大于bing-route,则/api/order/xxx会被bing-route拦截,转发到必应(不符合预期)。→ 匹配更精确的路由,order要设置更小的数字。

到此这篇关于SpringCloud Gateway路由表配置实现小结的文章就介绍到这了,更多相关SpringCloud Gateway路由配置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Java构造方法 super 及自定义异常throw合集详解用法

    Java构造方法 super 及自定义异常throw合集详解用法

    异常是程序中的一些错误,但不是所有错误都是异常,且错误有时候是可以避免的,super可以理解为是指向自己超(父)类对象的一个指针,而这个超类指的是离自己最近的一个父类,构造器也叫构造方法、构造函数,是一种特殊类型的方法,负责类中成员变量(域)的初始化
    2021-10-10
  • Java设计模式之策略模式详解和示例

    Java设计模式之策略模式详解和示例

    这篇文章主要介绍了Java设计模式之策略模式详解和示例,策略模式就是一种行为可能会因为不同的逻辑造成多个算法,比如人吃饭,美国人吃饭用刀叉,中国吃饭用筷子,都是吃饭的行为但是使用的工具(算法)不一样,需要的朋友可以参考下
    2024-01-01
  • Java Spring开发环境搭建及简单入门示例教程

    Java Spring开发环境搭建及简单入门示例教程

    这篇文章主要介绍了Java Spring开发环境搭建及简单入门示例,结合实例形式分析了spring环境搭建、配置、使用方法及相关注意事项,需要的朋友可以参考下
    2017-11-11
  • Springboot整合WebSocket 实现聊天室功能

    Springboot整合WebSocket 实现聊天室功能

    WebSocket是一种在单个TCP连接上进行全双工通信的协议,本文主要介绍了Springboot整合WebSocket实现聊天室功能,文中通过示例代码介绍的非常详细,需要的朋友们下面随着小编来一起学习学习吧
    2025-05-05
  • 解决idea spring boot 修改html等不重启即时生效的问题

    解决idea spring boot 修改html等不重启即时生效的问题

    这篇文章主要介绍了解决idea spring boot 修改html等不重启即时生效的问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2021-02-02
  • java String类常用方法练习小结

    java String类常用方法练习小结

    本文主要介绍了java String类常用方法的例子,具有很好的参考价值,下面跟着小编一起来看下吧
    2017-02-02
  • JavaWeb 入门:Hello Servlet

    JavaWeb 入门:Hello Servlet

    这篇文章主要介绍了Servlet开发JavaWeb工程示例详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-07-07
  • Java正则表达式_动力节点Java学院整理

    Java正则表达式_动力节点Java学院整理

    什么是正则表达式,正则表达式的作用是什么?这篇文章主要为大家详细介绍了Java正则表达式的相关资料,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-05-05
  • java自定义ClassLoader加载指定的class文件操作

    java自定义ClassLoader加载指定的class文件操作

    这篇文章主要介绍了java自定义ClassLoader加载指定的class文件操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2021-02-02
  • 基于Java Springboot + Vue + MyBatis实现音乐播放系统

    基于Java Springboot + Vue + MyBatis实现音乐播放系统

    这篇文章主要介绍了一个完整的音乐播放系统是基于Java Springboot + Vue + MyBatis编写的,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-08-08

最新评论