Spring Cloud Gateway?

最新推荐文章于 2025-09-03 17:28:45 发布

原创最新推荐文章于 2025-09-03 17:28:45 发布 · 604 阅读

9 ·

CC 4.0 BY-SA版权

文章标签：

#spring cloud #spring #后端

Spring框架专栏收录该内容

50 篇文章

订阅专栏

Spring Cloud Gateway 是一个基于 Spring Framework 和 Spring Boot 的 API 网关解决方案，主要用于路由、过滤、负载均衡和其他网关功能。它是 Spring Cloud 生态系统的一部分，旨在提供一个简单而灵活的网关框架来处理微服务架构中的请求路由和处理。

主要功能

路由（Routing）：
- Spring Cloud Gateway 能够将客户端请求路由到不同的后端服务。通过配置路由规则，可以指定请求的目标服务及其路径。
过滤（Filtering）：
- 支持请求和响应的过滤功能，包括请求的修改、响应的处理、添加头信息、身份验证、限流等。可以使用全局过滤器或特定路由的过滤器来处理请求和响应。
负载均衡（Load Balancing）：
- 与 Spring Cloud LoadBalancer 集成，支持客户端负载均衡。可以通过配置负载均衡策略来分配请求到不同的服务实例。
反向代理（Reverse Proxy）：
- 可以作为反向代理，将客户端请求代理到后端服务，并处理服务实例的生命周期变化。
断路器（Circuit Breaker）：
- 集成断路器功能，支持故障隔离和容错处理，提高系统的稳定性。
限流（Rate Limiting）：
- 支持基于 IP、请求路径、请求方法等的限流策略，防止系统被过多的请求压垮。
API 网关的管理：
- 提供动态路由和过滤器配置功能，通过配置中心（如 Spring Cloud Config）可以动态更新路由和过滤器。

核心概念

路由定义：

在 Spring Cloud Gateway 中，路由定义包括路由的 ID、匹配规则、转发目标等。可以通过 application.yml 配置文件、Java 配置类或在 Spring Boot 的自动配置机制中定义路由。

示例配置：

spring:
  cloud:
    gateway:
      routes:
        - id: my_route
          uri: http://localhost:8080
          predicates:
            - Path=/api/** 
          filters:
            - AddRequestHeader=Foo, Bar

过滤器：

过滤器用于处理请求和响应的修改。Spring Cloud Gateway 提供了多种内置过滤器（如 AddRequestHeader、StripPrefix 等），也支持自定义过滤器。

示例配置：

spring:
  cloud:
    gateway:
      routes:
        - id: my_route
          uri: http://localhost:8080
          predicates:
            - Path=/api/**
          filters:
            - StripPrefix=1
            - AddResponseHeader=X-Response-Foo, Bar

示例代码

1. 使用 application.yml 配置 Spring Cloud Gateway：

spring:
  cloud:
    gateway:
      routes:
        - id: my_route
          uri: http://localhost:8080
          predicates:
            - Path=/api/**
          filters:
            - AddRequestHeader=Foo, Bar

2. 使用 Java 配置类配置路由和过滤器：

import org.springframework.cloud.gateway.route.RouteLocator;
import org.springframework.cloud.gateway.route.builder.RouteLocatorBuilder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class GatewayConfig {

    @Bean
    public RouteLocator customRouteLocator(RouteLocatorBuilder builder) {
        return builder.routes()
                .route("my_route", r -> r.path("/api/**")
                        .uri("http://localhost:8080")
                        .filters(f -> f.addRequestHeader("Foo", "Bar")))
                .build();
    }
}