如何为WebFlux应用设置上下文路径？无需MVC或逐路由配置

嘿，我刚好处理过这个问题！在WebFlux里设置全局上下文路径完全不用挨个给路由加前缀，也不用切换回MVC，有两种很省心的方式，我给你详细说说：

1. 配置文件直接搞定（最推荐） #

如果你用的是Spring Boot 2.4及以上版本，这绝对是最简单的办法——直接在配置文件里加一行配置，所有路由自动带上前缀，完全不用改代码：

properties格式（application.properties） #

spring.webflux.base-path=/your-custom-context

yaml格式（application.yml） #

spring:
  webflux:
    base-path: /your-custom-context

举个例子：原来的路由是/api/users，配置后访问路径就变成/your-custom-context/api/users，完美适配所有路由。

2. 编程式配置（动态场景适用） #

如果需要根据环境动态调整上下文路径，或者用的是更早的Spring Boot版本，可以通过自定义WebFilter来实现全局路径前缀的添加：

import org.springframework.http.server.reactive.ServerHttpRequest;
import org.springframework.stereotype.Component;
import org.springframework.web.server.ServerWebExchange;
import org.springframework.web.server.WebFilter;
import org.springframework.web.server.WebFilterChain;
import reactor.core.publisher.Mono;

@Component
public class ContextPathFilter implements WebFilter {

    // 这里可以换成动态获取的路径，比如从配置中心读取
    private static final String CONTEXT_PATH = "/your-custom-context";

    @Override
    public Mono<Void> filter(ServerWebExchange exchange, WebFilterChain chain) {
        ServerHttpRequest request = exchange.getRequest();
        
        // 避免重复添加前缀
        if (request.getPath().startsWith(CONTEXT_PATH)) {
            return chain.filter(exchange);
        }
        
        // 重新构造请求，添加上下文路径前缀
        ServerHttpRequest modifiedRequest = request.mutate()
                .path(CONTEXT_PATH + request.getPath())
                .build();
        
        // 传递修改后的请求到后续链路
        return chain.filter(exchange.mutate().request(modifiedRequest).build());
    }
}

这种方式灵活性拉满，适合需要动态调整路径的场景，比如多环境部署时不同的上下文路径。

小提醒 #

• 如果你用的是Spring Boot 2.3及更早版本，可能会看到有人用server.servlet.context-path，但WebFlux本身不依赖Servlet容器（可以跑在Netty上），所以更推荐用spring.webflux.base-path（2.4+支持），这是官方为WebFlux专门设计的配置项。
• 千万别手动给每个路由加前缀，不仅麻烦还容易漏改，全局配置才是正道！

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