ianhuang筆記THE ADVENTURER'S JOURNAL
知識世界・持續探索中

ADVENTURE JOURNAL · 探索筆記

Spring Cloud Gateway:路由、過濾與 Actuator 邊界

任務導覽 TABLE OF CONTENTS

整理舊 WebFlux Gateway 配置,補上本地後端、路徑改寫與安全的端點確認。

適用:原Boot2的WebFlux Gateway歷史配置;新版替代線另列。外部服務以本地HTTP文字檔模擬,Gateway本身未於本次實機啟動。

選定架構與版本

原筆記以Boot2/Spring5/Reactor WebFlux Gateway為主,使用Cloud2021.0.x搭Boot2.7.x的舊語法。新版Gateway有WebFlux和Server MVC不同產品線與starter/property字首;按使用版本檔案選,不把spring-boot-starter-web混入WebFlux gateway。

已有相容Boot/Cloud BOM的gateway專案加入spring-cloud-starter-gateway與actuator。舊application.yml示意:

server:
  port: 8084
spring:
  cloud:
    gateway:
      routes:
        - id: note-backend
          uri: http://127.0.0.1:8085
          predicates:
            - Path=/notes/**
          filters:
            - StripPrefix=1
management:
  endpoints:
    web:
      exposure:
        include: health

新版WebFlux路由可能使用spring.cloud.gateway.server.webflux.routes,以對應版本配置索引為準。lb://服務名需discovery與load-balancer配置,本例固定URI不依賴Eureka。

本地確認

在另一目錄建立hello.txt內容campfire,使用python3 -m http.server 8085 --bind 127.0.0.1提供模擬後端。啟動Gateway後curl /notes/hello.txt應回campfire,StripPrefix去掉notes一段;請求/hello.txt不應匹配此route。

測後端停止時的錯誤、錯誤path與超時,再看gateway日誌;不是所有5xx都來自後端。Reactor鏈內不要做blocking IO,需按模型選擇適當整合方式。

Actuator

原筆記公開gateway並提供寫route/refresh示例;現行版本的enabled/access策略不同。若確需診斷,優先版本支援的read-only access、限定管理監聽與授權,再讀routes。不要把建立/刪除route介面當公開除錯功能,不能只靠CORS保護。

確認predicate、filter順序和傳往後端的path,客戶端看到200不代表認證、請求限制和錯誤處理完整。此篇僅檔案核對,未聲稱測完整gateway叢集。

JDK 25 的新版路線

若要與本系列的 JDK 25 練習一致,採 Spring Boot 3.5.16、java.version=25,並依官方相容表選 Spring Cloud 2025.0.x 的 BOM;此處的舊版組合不作為 JDK 25 的編譯成果。2025.0.x 是對應 Boot 3.5 的版本線,是否仍受支援須另查官方維護狀態。

新版 WebFlux 專案使用 spring-cloud-starter-gateway-server-webflux,路由配置改用 spring.cloud.gateway.server.webflux.routes,並沿用前面的本地 HTTP 後端作為測試資料。本文尚未以新版組合建置或啟動 Gateway;既有 YAML 是舊版本示意,不能直接宣稱 JDK 25 實測通過。

參考資料

冒險者留言

comments powered by Disqus

搜尋筆記

輸入關鍵字,探索所有筆記。

ESC 關閉 · 搜尋標題、標籤與文章全文