Spring Webflux如何阻止URL多斜杠自动合并并保留原始请求路径

负责合并斜杠的核心组件 #

Spring Webflux 5.3+默认使用的路径解析组件PathPatternParser负责该自动合并行为，其配置项mergeSlashes默认值为true，会自动将路径中连续的多个斜杠合并为单个斜杠，路径匹配、路径参数提取逻辑都会沿用处理后的路径结果。

解决方案 #

你可以按需选择以下两种方案实现需求：

方案1：全局关闭自动合并斜杠行为 #

通过自定义WebFlux路径匹配配置，全局修改PathPatternParser的默认行为，修改后所有路由匹配、路径参数提取、ServerWebExchange中获取的路径都会保留原始连续斜杠：

import org.springframework.context.annotation.Configuration
import org.springframework.web.reactive.config.PathMatchConfigurer
import org.springframework.web.reactive.config.WebFluxConfigurer
import org.springframework.web.util.pattern.PathPatternParser

@Configuration
class WebFluxPathConfig : WebFluxConfigurer {
    override fun configurePathMatching(configurer: PathMatchConfigurer) {
        val customParser = PathPatternParser().apply {
            // 关闭连续斜杠合并能力
            isMergeSlashes = false
            // 如果需要保留矩阵变量（分号开头的路径参数），可以同时关闭以下配置
            // isRemoveSemicolonContent = false
        }
        configurer.setPatternParser(customParser)
    }
}

如果你仅使用函数式路由，不需要全局生效，也可以仅给指定RouterFunction设置自定义解析器：

fun mainRouter(bookHandler: BookHandler) = router {
    PUT("/api/books/{fields:.*}", bookHandler::putBook)
}.withPathPatternParser(PathPatternParser().apply { isMergeSlashes = false })

配置完成后，你在Handler中获取pathVariable、在WebFilter中获取exchange.request.path都会正常保留连续斜杠。

方案2：直接获取原始请求路径无需修改全局配置 #

如果你的需求仅为校验路径中是否存在连续斜杠，不需要后续路径参数保留斜杠，不用修改全局配置，直接从请求URI的rawPath属性获取未经任何处理的原始路径字符串即可，不受PathPatternParser配置影响：

@Component
class Filter : WebFilter {
    override fun filter(exchange: ServerWebExchange, chain: WebFilterChain): Mono<Void> {
        // rawPath会保留原始的连续斜杠
        val originalPath = exchange.request.uri.rawPath
        // 直接判断originalPath中是否存在「//」即可完成空路径参数校验
        return chain.filter(exchange)
    }
}

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