Spring Cloud Gateway 是一个基于 Spring Boot 2.x 的可扩展的微服务网关，它提供了一种简单且灵活的方式来构建微服务架构中的 API 网关。Spring Cloud Gateway 专注于提供 API 网关所需的核心功能，如路由、断路器、限流等，同时支持自定义扩展点，以便用户能够根据自身需求进行定制。

下面我们将通过一个简单的示例来详细介绍 Spring Cloud Gateway 的使用。

添加依赖

首先，在我们的项目中添加 Spring Cloud Gateway 的依赖。在 pom.xml 文件中添加如下依赖：

    org.springframework.cloud
    spring-cloud-starter-gateway
    3.1.3

这里我们使用的是 Spring Cloud Gateway 的 3.1.3 版本。

配置路由规则

在 src/main/resources 目录下创建一个 application.yml 文件，用于配置路由规则。例如，我们定义两个服务 service-a 和 service-b，并设置相应的路由规则：

spring:
  cloud:
    gateway:
      routes:
        - id: route_a
          uri: http://service-a/api
          predicates:
            - Path=/api/a/**
        - id: route_b
          uri: http://service-b/api
          predicates:
            - Path=/api/b/**

在这个例子中，我们定义了两个路由规则。route_a 规则将 /api/a/** 路径的请求转发到 http://service-a/api，route_b 规则将 /api/b/** 路径的请求转发到 http://service-b/api。

自定义扩展点

Spring Cloud Gateway 提供了许多内置的扩展点，允许用户根据需要进行定制。例如，我们可以实现org.springframework.cloud.gateway.handler.predicate.PredicateFactory 接口来定义新的路由规则条件。

这里我们创建一个自定义的路由规则条件 MyCustomPredicate，用于判断请求是否满足某些特定的条件：

package com.example.myservice.gateway;

import org.springframework.cloud.gateway.handler.predicate.PredicateFactory;
import org.springframework.cloud.gateway.handler.predicate.RoutePredicate;
import org.springframework.cloud.gateway.route.builder.RouteLocatorBuilder;
import org.springframework.cloud.gateway.route.builder.routes.RouteLocator;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.server.reactive.ServerHttpRequest;
import org.springframework.web.server.ServerWebExchange;
import reactor.core.publisher.Mono;

@Configuration
public class MyGatewayConfig {
    @Bean
    public RoutePredicate myCustomPredicate(PredicateFactory predicateFactory) {
        return predicateFactory.fromState(ServerWebExchange::getRequest, ServerHttpRequest::getURI)
                ::equals(ServerHttpRequest::getURI) // 这里简单判断请求的 URI 是否与目标 URI 相等
                .then(Mono::just); // 如果相等，返回 Mono 类型的 true
    }
}

在这个例子中，我们定义了一个 MyCustomPredicate 类，实现了 RoutePredicate 接口。在 myCustomPredicate 方法中，我们通过ServerWebExchange::getRequest 和 ServerHttpRequest::getURI 方法获取请求的信息，并进行简单的判断。如果请求的 URI 与目标 URI 相等，返回 Mono 类型的 true。这样，我们就可以将这个条件应用于路由规则中。

启动网关

在完成上述配置后，我们可以启动 Spring Cloud Gateway 网关。启动方法与普通的 Spring Boot 应用类似，只需运行 mvn spring-boot:run 命令即可。

Spring Cloud Gateway 启动后，会监听默认的端口 8080。如果需要修改端口号，可以在 application.yml 文件中设置 server.port 属性。

路由测试

我们可以通过发送 HTTP 请求来测试路由规则是否生效。例如，可以借助 Postman 或curl命令来进行测试。

对于上述示例中的路由规则，我们可以分别发送以下请求：

• 请求 route_a 路由规则：

curl -X GET http://localhost:8080/api/a/hello

• 请求 route_b 路由规则：

curl -X GET http://localhost:8080/api/b/hello

如果一切正常，你应该能够分别获得来自 service-a 和 service-b 的响应结果。

自定义扩展点使用

在上述示例中，我们创建了一个自定义的路由规则条件 MyCustomPredicate。要使用这个条件，我们需要在 application.yml 文件中添加以下配置：

spring:
  cloud:
    gateway:
      routes:
        - id: route_with_custom_predicate
          uri: http://service-a/api
          predicates:
            - MyCustomPredicate=true

在这个例子中，我们创建了一个新的路由规则route_with_custom_predicate，并添加了 MyCustomPredicate=true 条件。这意味着只有当请求满足 MyCustomPredicate 条件时，才会转发请求到目标服务。

日志与监控

Spring Cloud Gateway 还提供了丰富的日志和监控功能。你可以通过配置 logging.level.* 和 management.endpoint.* 等属性来启用并定制日志和监控行为。例如，在 application.yml 文件中添加以下配置：

logging:
  level:
    root: INFO
management:
  endpoint:
    health:
      show-details: always

这样，你就能在日志中看到更详细的路由、断路器、限流等信息，并可以通过 /health 接口查看网关的健康状态。