本文详解如何在 spring cloud gateway 中正确配置重定向，使请求路径（如 /site/rest/services/testservice/1）完整保留在目标 url 中，避免仅跳转到根路径。核心在于动态构造目标 uri，而非硬编码重定向地址。
在 Spring Cloud Gateway 中，直接使用 f.redirect(302, "https://internal-api.com") 会导致路径丢失——因为该过滤器仅将客户端重定向至指定 URL 的根路径（即 https://internal-api.com/），而不会自动拼接原始请求路径（如 /site/rest/services/testservice/1）。这是 RedirectToGatewayFilterFactory 的设计行为：它只接受一个固定目标 URI，不支持路径模板或变量注入。
✅ 正确解法是手动修改请求 URI，再配合 redirect 过滤器（或更推荐：直接返回 302 响应），确保重定向 Location 头包含完整的路径。以下是经过验证的生产级实现：
@Bean
public RouteLocator routes(RouteLocatorBuilder builder) {
String auth = username + ":" + password;
String encodedAuth = Base64.getEncoder().encodeToString(auth.getBytes());
return builder.routes()
.route("geoApi", r -> r
.path("/site/rest/services/**")
.filters(f -> f
.setHeader(HttpHeaders.AUTHORIZATION, "Basic " + encodedAuth)
// ✅ 关键：动态构建目标 URI，保留原始路径与查询参数
.modifyRequestBody(Void.class, Void.class, (exchange, body) -> {
// 注意：此处仅用于触发链式调用；实际重定向由下方 redirect 完成
return Mono.just(body);
})
// ✅ 核心：使用 changeRequestUri 动态生成含路径的目标地址
.changeRequestUri(exchange -> {
URI originalUri = exchange.getRequest().getURI();
UriComponentsBuilder builder = UriComponentsBuilder
.fromUri(originalUri)
.scheme("https")
.host("internal-api.com")
.port(-1); // -1 表示移除端口（若原 URI 无端口）
return Optional.of(builder.build(true).toUri());
})
// ✅ 触发 302 重定向（此时 request URI 已更新，Location 即为其值）
.redirect(302, exchange -> exchange.getRequest().getURI())
)
.uri("https://dummy.com") // ⚠️ 此 uri 不参与重定向逻辑，仅作占位（必须非空）
)
.build();
}⚠️ 重要说明与注意事项：
- changeRequestUri 是 Gateway 3.1+ 推荐的方式（替代已废弃的 rewritePath + redirect 组合），它在路由匹配后、过滤器执行前修改请求上下文中的 URI，后续 redirect 过滤器会自动读取该 URI 作为重定向目标。
- .uri("https://dummy.com") 是必需的占位符——Spring Cloud Gateway 要求每个路由必须声明 uri()，但它不会被实际调用；真正的目标由 changeRequestUri 和 redirect 共同决定。
- 若需添加认证头（如 Basic Auth），请确保 setHeader 在 changeRequestUri 之前执行，否则可能因请求上下文未就绪导致异常。
- 不建议使用字符串拼接（如 "https://internal-api.com" + originalUri.getPath()），因为它会丢失查询参数（?key=value）和编码信息；UriComponentsBuilder 可安全保留全部 URI 组成部分。
? 进阶提示：
若需更灵活控制（如条件重定向、多环境 Host 切换），可将 internal-api.com 提取为配置项（如 @Value("${api.internal.host}")），并结合 RouteLocatorBuilder 的 id() 和 order() 实现优先级路由。
综上，通过 changeRequestUri 动态重建目标 URI，是 Spring Cloud Gateway 中实现路径感知重定向最清晰、可靠且符合官方最佳实践的方式。
