# application.yml——一条完整的路由配置
spring:
  cloud:
    gateway:
      routes:
        - id: user-service                # ① 路由 ID——唯一标识
          uri: http://localhost:8081       # ② 目标 URI——请求最终发到这里
          predicates:                      # ③ Predicate——匹配条件的集合
            - Path=/api/users/**           #    路径匹配——/api/users/xxx 开头的请求
          filters:                         # ④ Filter——处理规则
            - StripPrefix=1                #    转发前去掉前 1 段——/api/users/xxx → /xxx

- id: user-service-v2
  uri: http://localhost:8082
  predicates:
    - Path=/api/users/**           # 路径匹配
    - Header=X-Version, v2         # 且——Header 中 X-Version = v2
    - Method=GET                   # 且——只匹配 GET 请求
  # 三个条件同时满足 → 请求被路由到此

// 一个典型的 GatewayFilter 执行流程
public class LoggingFilter implements GatewayFilter {
    @Override
    public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
        // ① 转发之前——Pre Filter：记录请求日志
        System.out.println("收到请求: " + exchange.getRequest().getURI());

        // ② 转发——调用下一个 Filter 或最终转发到后端
        return chain.filter(exchange)
                .then(Mono.fromRunnable(() -> {
                    // ③ 转发之后——Post Filter：记录响应日志
                    System.out.println("响应状态: " +
                            exchange.getResponse().getStatusCode());
                }));
    }
}

<dependencies>
    <!-- Spring Cloud Gateway 核心 -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-gateway</artifactId>
    </dependency>

    <!-- 服务发现——Gateway 从 Nacos 发现后端服务 -->
    <dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    </dependency>

    <!-- 注意：千万不要引入 spring-boot-starter-web！
         Gateway 基于 WebFlux——不是 Servlet -->
</dependencies>

# application.yml
server:
  port: 8080

spring:
  application:
    name: api-gateway
  cloud:
    gateway:
      routes:
        # 路由 1——转发用户服务
        - id: user-service
          uri: http://localhost:8081
          predicates:
            - Path=/api/users/**
          filters:
            - StripPrefix=1          # /api/users/1 → 转发到 http://localhost:8081/1

        # 路由 2——转发订单服务
        - id: order-service
          uri: http://localhost:8082
          predicates:
            - Path=/api/orders/**
          filters:
            - StripPrefix=1

# 启动网关（端口 8080）和两个后端服务（8081、8082）

# 测试——浏览器访问网关的地址
curl http://localhost:8080/api/users/1
# 网关收到请求 → Predicate 匹配到 user-service Route
# → StripPrefix=1 去掉 /api/users → 转发到 http://localhost:8081/1
# → 用户服务返回用户信息

curl http://localhost:8080/api/orders/100
# 网关收到请求 → Predicate 匹配到 order-service Route
# → StripPrefix=1 去掉 /api/orders → 转发到 http://localhost:8082/100
# → 订单服务返回订单信息

@Configuration
public class GatewayRouteConfig {

    @Bean
    public RouteLocator customRoutes(RouteLocatorBuilder builder) {
        return builder.routes()
                // 路由 1——用户服务
                .route("user-service", r -> r
                        .path("/api/users/**")        // Predicate：路径匹配
                        .filters(f -> f
                                .stripPrefix(1)        // Filter：去掉前 1 段
                                .addRequestHeader("X-Source", "gateway")) // Filter：加请求头
                        .uri("http://localhost:8081")) // 目标 URI

                // 路由 2——订单服务
                .route("order-service", r -> r
                        .path("/api/orders/**")
                        .filters(f -> f.stripPrefix(1))
                        .uri("http://localhost:8082"))

                .build();
    }
}

spring:
  cloud:
    gateway:
      discovery:
        locator:
          enabled: true            # 开启服务发现自动路由
          lower-case-service-id: true  # 服务名转小写
      routes:
        - id: user-service
          uri: lb://user-service   # ← lb:// = Load Balance——从 Nacos 查到实例列表
          predicates:
            - Path=/api/users/**
          filters:
            - StripPrefix=1

        - id: order-service
          uri: lb://order-service
          predicates:
            - Path=/api/orders/**
          filters:
            - StripPrefix=1

// ⚠️ 在 Gateway 中写业务逻辑 = 反模式
// ❌ 不要在 Filter 中查数据库
// ❌ 不要在 Filter 中做复杂计算
// ✅ Filter 只做：鉴权、限流、日志、Header 操作、路由转发