Spring WebFlux WebFilter实现多租户请求映射至应用根页面

在Spring WebFlux中，没有直接对应Servlet里request.getRequestDispatcher().forward()的API，但可以通过修改请求路径并设置内部转发属性来实现相同效果——既让服务器处理/路径的请求（加载Angular首页），又保持浏览器地址栏的/tenant/tenantname/不变。

问题分析 #

你当前的代码仅修改了请求路径，但未标记为内部转发，可能导致后续处理逻辑（如静态资源控制器）触发不必要的重定向，或者Angular路由识别到路径变化后主动跳转。而Servlet的forward是服务器内部处理，浏览器完全感知不到路径变化，因此地址栏保持原样。

修改后的WebFilter代码 #

@Component
public class TenantFilter implements WebFilter {
    // 正则匹配租户路径，精准提取租户名称
    private static final Pattern TENANT_PATTERN = Pattern.compile("^/tenant/([^/]+)/?$");

    @Override
    public Mono<Void> filter(ServerWebExchange exchange, WebFilterChain chain) {
        String requestPath = exchange.getRequest().getPath().value();
        Matcher matcher = TENANT_PATTERN.matcher(requestPath);

        if (matcher.matches()) {
            // 1. 提取租户名称，存入Exchange属性供后续业务逻辑调用
            String tenantName = matcher.group(1);
            exchange.getAttributes().put("tenantId", tenantName);

            // 2. 构造转发到"/"的请求
            ServerHttpRequest forwardedRequest = exchange.getRequest().mutate()
                    .path("/")
                    .build();

            // 3. 设置内部转发属性，标记当前请求为服务器内部转发
            exchange.getAttributes().put(ServerWebExchangeUtils.FORWARD_REQUEST_URI_ATTRIBUTE, "/");
            exchange.getAttributes().put(ServerWebExchangeUtils.FORWARD_PATH_ATTRIBUTE, "/");

            // 4. 使用修改后的请求继续处理，等效于Servlet的forward
            return chain.filter(exchange.mutate().request(forwardedRequest).build());
        }

        // 非租户路径，直接放行
        return chain.filter(exchange);
    }
}

关键说明 #

1. 租户提取：用正则精确匹配路径，避免误判包含"tenant"的普通路径；提取的租户名称存入ServerWebExchange的属性中，后续的Controller或其他组件可以通过exchange.getAttribute("tenantId")获取。
2. 内部转发标记：通过ServerWebExchangeUtils的两个属性标记请求为内部转发，确保后续处理器（如静态资源处理器）不会触发重定向，而是直接返回/对应的响应（Angular的index.html）。
3. Angular路由兼容：需要确保Angular应用支持当前地址栏的路径。如果你的Angular路由不需要处理租户路径，可以在路由配置中添加通配符路由，将所有未匹配的路径导向首页组件：

   const routes: Routes = [
     // 你的其他业务路由
     { path: 'tenant/:tenantName', component: HomeComponent },
     { path: '**', redirectTo: '' }
   ];
   

额外注意事项 #

• 确保Spring Boot的静态资源配置正确：默认情况下，Spring会将classpath:/static/下的index.html映射为/的响应，无需额外配置。
• 如果Angular打包时设置了base-href，需要确保其值为/，避免路由路径混乱。

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