Repolode
提交项目
spring-cloud

spring-cloud/spring-cloud-gateway

基于 Spring Framework 和 Spring Boot 构建的 API 网关，用于微服务中的 HTTP 请求路由与过滤。

在 GitHub 查看官网
Star
4,919
Fork
3,481
未关闭 Issue
565
最近提交
20小时前

这是什么？

Spring Cloud Gateway 是一个面向 Java 应用的 API 网关，基于 Spring Framework 6 和 Spring Boot 3 构建，运行环境为 Java 17。它位于后端服务之前，根据路径、HTTP 方法、请求头或 Host 等匹配规则，将请求转发到对应的服务。

路由与过滤器绑定：每个过滤器只作用于匹配该路由的请求。过滤器可以增删改请求头和参数，重写或设置请求路径，并支持熔断等能力。路由既可以通过 API 定义，也可以通过配置文件定义，还能基于 Spring Cloud DiscoveryClient 自动生成。

项目使用 Maven 构建，需要 JDK 17，可直接运行 ./mvnw 进行编译和测试。依赖 Redis 等中间件的测试需要本地运行 Docker。

核心功能

  • 01按路径、HTTP 方法、请求头、Host 等请求属性匹配路由
  • 02过滤器仅作用于匹配的具体路由
  • 03过滤器可修改请求和响应的头部、参数与路径
  • 04内置熔断等过滤器能力
  • 05路由可通过 API、配置或 Spring Cloud DiscoveryClient 定义

适用场景

  • 为一组 Spring Boot 微服务提供统一入口和路由
  • 在请求到达后端服务前增删改请求头或重写路径
  • 结合服务发现，让路由自动跟随已注册的服务

快速上手

  1. 1

    克隆项目仓库

  2. 2

    安装 JDK 17 并使用 Maven 包装器构建源码

    ./mvnw install

使用前须知

  • 构建需要 JDK 17。
  • 部分测试需要本地运行的 Docker 实例。

收录于专题

微服务框架与服务基础设施

标签

#api-gateway#java#spring-boot#microservices#reverse-proxy#reactive#proxy#reactor#spring#spring-cloud

常见问题

spring-cloud-gateway 是什么？
基于 Spring Framework 和 Spring Boot 构建的 API 网关，用于微服务中的 HTTP 请求路由与过滤。 Spring Cloud Gateway 是一个面向 Java 应用的 API 网关，基于 Spring Framework 6 和 Spring Boot 3 构建，运行环境为 Java 17。它位于后端服务之前，根据路径、HTTP 方法、请求头或 Host 等匹配规则，将请求转发到对应的服务。
spring-cloud-gateway 可以免费使用吗？用的什么许可证？
spring-cloud-gateway 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。
spring-cloud-gateway 还在维护吗？
活跃维护中。spring-cloud-gateway 最近一次提交是在 2026年11月6日。
spring-cloud-gateway 适合用来做什么？
为一组 Spring Boot 微服务提供统一入口和路由 在请求到达后端服务前增删改请求头或重写路径 结合服务发现，让路由自动跟随已注册的服务
spring-cloud-gateway 怎么安装和运行？
克隆项目仓库 安装 JDK 17 并使用 Maven 包装器构建源码: ./mvnw install
在哪里获取 spring-cloud-gateway？
源代码和安装说明在 GitHub 上：https://github.com/spring-cloud/spring-cloud-gateway

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目