Spring Cloud Gateway可通过配置文件或Java代码配置路由，推荐使用yml方式。示例中通过Path断言匹配请求路径，StripPrefix过滤器去除前缀后转发至指定uri；也可通过RouteLocatorBuilder编写Java配置实现更灵活的路由逻辑；结合Eureka时使用lb://协议实现服务发现与负载均衡；需注意避免引入spring-webmvc以防止与WebFlux冲突，且路由顺序影响匹配优先级。
在Java后端开发中，Spring Cloud Gateway 是微服务架构里常用的网关组件，负责请求的路由转发和过滤。配置路由是它的核心功能之一。你可以通过两种方式来配置：一种是使用配置文件（推荐），另一种是通过 Java 代码硬编码。
1. 使用 application.yml 配置路由
这是最常见、最简洁的方式。你只需要在 application.yml 文件中定义路由规则即可。
示例配置：
spring:
cloud:
gateway:
routes:
- id: user-service-route
uri: http://localhost:8081
predicates:
- Path=/api/users/**
filters:
- StripPrefix=1
<pre class='brush:java;toolbar:false;'> - id: order-service-route
uri: http://localhost:8082
predicates:
- Path=/api/orders/**
filters:
- StripPrefix=1说明：
立即学习“Java免费学习笔记（深入）”；
- id：路由唯一标识。
-
uri：目标服务地址，可以是 http 地址，也可以是 lb:// 开头的负载均衡服务名（如
lb://userservice）。 -
predicates：断言，用于匹配请求。上面的
Path=/api/users/**表示路径以 /api/users/ 开头的请求会被转发。 -
filters：过滤器，
StripPrefix=1表示去掉第一层路径前缀再转发。比如 /api/users/list 转发到后端时变为 /list。
2. 使用 Java 配置类方式
如果你需要更灵活的控制，可以用 Java 代码定义路由。
示例：
@Configuration
public class GatewayConfig {
<pre class='brush:java;toolbar:false;'>@Bean
public RouteLocator customRouteLocator(RouteLocatorBuilder builder) {
return builder.routes()
.route("user_route", r -> r.path("/api/users/**")
.filters(f -> f.stripPrefix(1))
.uri("http://localhost:8081"))
.route("order_route", r -> r.path("/api/orders/**")
.filters(f -> f.stripPrefix(1))
.uri("http://localhost:8082"))
.build();
}}
这种方式适合动态或条件性路由逻辑，但日常使用中 yml 更清晰。
3. 结合 Eureka 实现服务发现
在微服务场景下，通常配合注册中心（如 Eureka）使用，让网关自动发现服务实例。
配置示例：
spring:
cloud:
gateway:
routes:
- id: user-service
uri: lb://user-service
predicates:
- Path=/api/users/**
filters:
- StripPrefix=1
注意：uri 使用 lb:// 前缀表示启用负载均衡，user-service 是服务在 Eureka 中注册的名称。
4. 常见问题和建议
确保以下几点避免常见错误：
- 添加必要的依赖，如
spring-cloud-starter-gateway和spring-cloud-starter-netflix-eureka-client（如果用了注册中心）。 - 不要在项目中引入
spring-webmvc，否则会与 WebFlux 冲突。 - 路径匹配顺序很重要，写在前面的路由优先级更高。
- 可以用多个 predicate 组合，如 Host、Method、Query 等。
基本上就这些。用 yml 配置路由简单高效，适合大多数场景。结合服务发现后，网关能自动路由到正确的微服务。
