快捷導(dǎo)航

SpringCloud Gateway路由表配置實(shí)現(xiàn)小結(jié)

更新時(shí)間：2026年01月14日 08:59:55 作者：南嶼欣風(fēng)

SpringCloudGateway通過(guò)路由表將請(qǐng)求轉(zhuǎn)發(fā)到不同的服務(wù)或地址,每個(gè)路由包含id、uri、predicates和filters等字段,下面就來(lái)介紹一下SpringCloud Gateway路由如何配置,感興趣的可以了解一下

一、基礎(chǔ)結(jié)構(gòu)

路由表配置在spring.cloud.gateway.routes下，每個(gè)路由是一個(gè)獨(dú)立的配置項(xiàng)，包含以下核心字段：

spring:
  cloud:
    gateway:
      routes:
        - id: 路由唯一標(biāo)識(shí)  # 每個(gè)路由必須有唯一id
          uri: 目標(biāo)地址       # 請(qǐng)求要轉(zhuǎn)發(fā)到的地址
          predicates: []      # 路由匹配規(guī)則（滿足條件才轉(zhuǎn)發(fā)）
          filters: []         # 路由過(guò)濾器（轉(zhuǎn)發(fā)前后的加工邏輯）
          order: 優(yōu)先級(jí)數(shù)字   # 數(shù)字越小，優(yōu)先級(jí)越高

二、示例配置拆解

以示例中的兩個(gè)路由為例，解析不同場(chǎng)景的配置邏輯：

1. 轉(zhuǎn)發(fā)到外部地址（bing-route）

- id: bing-route  # 路由id：bing-route
  uri: https://cn.bing.com/  # 目標(biāo)地址：必應(yīng)官網(wǎng)（外部地址）
  predicates:
    - Path=/**  # 匹配規(guī)則：所有路徑（任意請(qǐng)求都能匹配）
  filters: []   # 無(wú)過(guò)濾器
  order: 10     # 優(yōu)先級(jí)：10（數(shù)字大，優(yōu)先級(jí)低）
  metadata:     # 自定義元數(shù)據(jù)（非核心，可用于擴(kuò)展邏輯）
    hello: world

作用：所有請(qǐng)求都會(huì)被轉(zhuǎn)發(fā)到必應(yīng)官網(wǎng)；
注意：uri填外部地址時(shí)，直接寫(xiě)完整的 HTTP/HTTPS 地址。

2. 轉(zhuǎn)發(fā)到微服務(wù)（order-route）

- id: order-route  # 路由id：order-route
  uri: lb://service-order  # 目標(biāo)地址：微服務(wù)service-order（lb=負(fù)載均衡）
  predicates:
    - Path=/api/order/**  # 匹配規(guī)則：以/api/order/開(kāi)頭的路徑
  order: 1  # 優(yōu)先級(jí)：1（數(shù)字小，優(yōu)先級(jí)高）

作用：只有路徑以/api/order/開(kāi)頭的請(qǐng)求，才會(huì)轉(zhuǎn)發(fā)到service-order微服務(wù)；
關(guān)鍵：uri: lb://服務(wù)名是微服務(wù)場(chǎng)景的寫(xiě)法，lb表示開(kāi)啟負(fù)載均衡（需配合 Nacos/Eureka 等注冊(cè)中心）。

三、核心字段說(shuō)明

字段名	作用
id	路由唯一標(biāo)識(shí)，不能重復(fù)
uri	轉(zhuǎn)發(fā)目標(biāo)：- 外部地址：https://xxx.com - 微服務(wù)：lb://服務(wù)名
predicates	路由匹配規(guī)則（多個(gè)規(guī)則需同時(shí)滿足），常用Path=/xxx/** （路徑匹配）
filters	過(guò)濾器（如添加請(qǐng)求頭、路徑重寫(xiě)等），空數(shù)組表示無(wú)過(guò)濾
order	路由優(yōu)先級(jí)：數(shù)字越小，優(yōu)先級(jí)越高（多個(gè)路由匹配時(shí)，優(yōu)先走 order 小的）

四、優(yōu)先級(jí)注意事項(xiàng)

示例中order-route的order=1，bing-route的order=10：

當(dāng)請(qǐng)求路徑是/api/order/xxx時(shí)，會(huì)先匹配order-route（因?yàn)閮?yōu)先級(jí)更高），轉(zhuǎn)發(fā)到service-order；
若order-route的order大于bing-route，則/api/order/xxx會(huì)被bing-route攔截，轉(zhuǎn)發(fā)到必應(yīng)（不符合預(yù)期）。→ 匹配更精確的路由，order要設(shè)置更小的數(shù)字。

到此這篇關(guān)于SpringCloud Gateway路由表配置實(shí)現(xiàn)小結(jié)的文章就介紹到這了,更多相關(guān)SpringCloud Gateway路由配置內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: