SpringCloudGateway跨域重定向设置方法

从现在开始，我们要努力学习啦！今天我给大家带来《Spring Cloud Gateway 跨域重定向实现方法》，感兴趣的朋友请继续看下去吧！下文中的内容我们主要会涉及到等等知识点，如果在阅读本文过程中有遇到不清楚的地方，欢迎留言呀！我们一起讨论，一起学习！

本文详解如何在 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 中实现路径感知重定向最清晰、可靠且符合官方最佳实践的方式。

以上就是《SpringCloudGateway跨域重定向设置方法》的详细内容，更多关于的资料请关注golang学习网公众号！