本文详解如何在 spring cloud gateway 中配置路由，使请求不仅重定向到目标主机，还能完整保留原始路径与查询参数，避免仅跳转至根路径的问题。
在 Spring Cloud Gateway 中，RedirectToGatewayFilterFactory（即 f.redirect(statusCode, uri)）默认仅接受一个静态目标 URI 字符串，它会忽略原始请求路径，直接跳转到该 URI 的根路径（如 "https://internal-api.com" → https://internal-api.com/），无法自动拼接原始路径 /site/rest/services/testservice/1。因此，单纯调用 .redirect(302, "https://internal-api.com") 会导致路径丢失。
要实现路径透传式重定向（即 http://localhost:8080/site/rest/services/testservice/1?x=1 → https://internal-api.com/site/rest/services/testservice/1?x=1），必须动态构造重定向 Location 头，而非依赖内置 redirect filter。推荐使用 changeRequestUri + 自定义 URI 重建的方式，配合手动设置 Location 响应头完成 302 重定向。
以下是完整、可运行的配置示例：
@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
// 1. 动态构建重定向目标 URI：复用原请求路径 + 新 host/scheme
.changeRequestUri(exchange -> {
URI originalUri = exchange.getRequest().getURI();
UriComponentsBuilder builder = UriComponentsBuilder.fromUri(originalUri)
.scheme("https")
.host("internal-api.com")
.port(-1); // -1 表示移除端口（若原请求无端口）
return Optional.of(builder.build(true).toUri());
})
// 2. 手动添加 302 重定向响应头（关键！）
.setResponseHeader(HttpHeaders.LOCATION,
"{uri}") // SpEL 表达式，由 Gateway 自动解析为 changeRequestUri 构造后的 URI
// 3. 设置状态码为 302（需配合 setResponseHeader 使用）
.setResponseStatus(HttpStatus.MOVED_TEMPORARILY)
// 4. 可选：添加认证头（作用于重定向响应的 Location 不生效，但若后续请求需鉴权，建议在下游服务处理）
.setRequestHeader(HttpHeaders.AUTHORIZATION, "Basic " + encodedAuth)
)
.uri("https://dummy.com")) // 此 uri 仅作占位（因实际不转发，而是重定向），可设为任意合法 URI
.build();
}⚠️ 重要说明与注意事项：
- changeRequestUri 本身不会触发重定向，它只是修改 Gateway 内部对下游请求的 URI 解析；真正实现重定向的是 setResponseHeader("Location", "{uri}") + setResponseStatus(302) 组合；
- {uri} 是 Spring Cloud Gateway 内置的 SpEL 表达式，会自动解析为 changeRequestUri 函数返回的 URI（已含完整路径和查询参数）；
- setRequestHeader(...) 在重定向场景下对客户端无效（重定向是响应行为，客户端收到 Location 后发起新请求），如需目标服务鉴权，请确保 internal-api.com 能校验 Basic Auth，或改用 OAuth2、JWT 等网关级统一认证方案；
- 若需支持 HTTPS 证书信任（如 internal-api.com 使用自签名证书），需额外配置 HttpClient 并注入 WebClient.Builder，此处略；
- 替代方案（不推荐）：使用 RewritePath + SetPath 配合 uri("https://internal-api.com") 实现代理转发（非重定向），适用于无需暴露目标地址的场景。
总结：Spring Cloud Gateway 的“重定向”需区分「响应式重定向」（302 + Location）与「透明代理转发」。当明确需要客户端跳转且保留路径时，应放弃 redirect() 工厂方法，转而组合 changeRequestUri、setResponseHeader("Location", "{uri}") 和 setResponseStatus 三步完成精准控制。
