Spring Cloud Gateway中302重定向位置错误问题咨询

问题现象 #

通过Spring Cloud Gateway访问gateway-url/togglz-console/index，点击功能状态切换按钮后，功能状态修改成功，但页面被重定向至service-url/togglz-console/edit，而非预期的网关端点。请求流程如下：

1. 访问 gateway-url/togglz-console/index
2. 提交表单至 gateway-url/togglz-console/edit
3. 服务返回302响应，Location指向 service-url/togglz-console/edit

使用的Togglz依赖：

• org.togglz:togglz-spring-boot-starter:4.4.0
• org.togglz:togglz-spring-security:4.4.0
• org.togglz:togglz-console:4.4.0
• com.github.heneke.thymeleaf:thymeleaf-extras-togglz:2.0.1.RELEASE

问题原因 #

Togglz控制台处理表单提交后的重定向URL默认从当前请求的ServletContext获取服务自身地址，未考虑Spring Cloud Gateway的前置路由，导致重定向目标错误。

解决方案 #

方案1：配置Togglz控制台Base URL #

直接通过配置指定Togglz控制台的基础URL为网关入口路径，让Togglz生成正确的重定向地址。

YAML配置（application.yml）：

togglz:
  console:
    path: /togglz-console
    base-url: http://your-gateway-host:port/togglz-console

Properties配置（application.properties）：

togglz.console.path=/togglz-console
togglz.console.base-url=http://your-gateway-host:port/togglz-console

方案2：自定义Togglz Console Servlet初始化参数 #

如果配置文件方式不生效，可以通过代码自定义Servlet注册，显式设置base-url参数：

import org.togglz.console.TogglzConsoleServlet;
import org.springframework.boot.web.servlet.ServletRegistrationBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class TogglzConsoleConfig {

    @Bean
    public ServletRegistrationBean<TogglzConsoleServlet> togglzConsoleServlet() {
        ServletRegistrationBean<TogglzConsoleServlet> registration = new ServletRegistrationBean<>(new TogglzConsoleServlet(), "/togglz-console/*");
        // 替换为实际网关地址
        registration.addInitParameter("base-url", "http://your-gateway-host:port/togglz-console");
        return registration;
    }
}

方案3：Spring Cloud Gateway重写重定向响应 #

若无法修改服务端配置，可在网关层添加过滤器，拦截302响应并替换Location中的服务URL为网关URL：

自定义网关过滤器

import org.springframework.cloud.gateway.filter.GatewayFilter;
import org.springframework.cloud.gateway.filter.factory.AbstractGatewayFilterFactory;
import org.springframework.http.HttpHeaders;
import org.springframework.stereotype.Component;
import reactor.core.publisher.Mono;

@Component
public class RedirectRewriteFilter extends AbstractGatewayFilterFactory<RedirectRewriteFilter.Config> {

    // 替换为实际服务地址和网关地址
    private static final String SERVICE_URL = "http://your-service-host:port";
    private static final String GATEWAY_URL = "http://your-gateway-host:port";

    public RedirectRewriteFilter() {
        super(Config.class);
    }

    @Override
    public GatewayFilter apply(Config config) {
        return (exchange, chain) -> chain.filter(exchange).then(Mono.fromRunnable(() -> {
            exchange.getResponse().getHeaders().entrySet().stream()
                    .filter(entry -> HttpHeaders.LOCATION.equals(entry.getKey()))
                    .forEach(entry -> {
                        String originalLocation = entry.getValue().get(0);
                        String newLocation = originalLocation.replace(SERVICE_URL, GATEWAY_URL);
                        entry.getValue().set(0, newLocation);
                    });
        }));
    }

    public static class Config {
        // 可添加自定义配置参数
    }
}

路由中配置过滤器

spring:
  cloud:
    gateway:
      routes:
        - id: togglz-service-route
          uri: http://your-service-host:port
          predicates:
            - Path=/togglz-console/**
          filters:
            - name: RedirectRewriteFilter

内容的提问来源于stack exchange，提问作者Sinch