Spring Cloud Gateway异步Filter无法终止请求链问题排查

异步实现的核心问题是：无论是否触发拦截逻辑，你最后都无条件返回了chain.filter(exchange)，这会强制请求链继续向后执行，直接覆盖你之前设置的FORBIDDEN响应状态。而阻塞实现里，拦截时直接返回response.setComplete()，通过终止返回流的方式切断了请求链。

修改flatMap内的分支逻辑，在需要拦截时返回response.setComplete()的Mono，否则再放行请求：

override fun filter(exchange: ServerWebExchange, chain: GatewayFilterChain): Mono<Void> {
    logger.info("Feature Security Filter")

    // getFeatures returns Mono<Map<String, Boolean>>
    return featureConfigService.getFeatures().flatMap { features ->
        val path = exchange.request.path.toString()
        val method = exchange.request.method.toString()

        // 合并路径匹配与权限校验逻辑，避免重复计算
        val isRestricted = featureMappings.keys.any { it.matcher(path).matches() } &&
                featureMappings
                    .filter { it.key.matcher(path).matches() }
                    .any { features[it.value.requiresFeature] != true || !it.value.methodsAllowed.contains(method) }

        if (isRestricted) {
            logger.warn("Access to path [$method|$path] restricted. ")
            val response = exchange.response
            response.statusCode = HttpStatus.FORBIDDEN
            response.setComplete()
        } else {
            chain.filter(exchange)
        }
    }
}

1. 正确终止请求链：在异步场景下，拦截请求必须通过返回response.setComplete()的Mono来实现，这个方法返回的Mono<Void>会告知网关响应已完成，不再执行后续Filter。
2. 简化逻辑判断：合并两次路径匹配与权限校验的逻辑，避免重复调用matcher，提升请求处理性能。
3. 遵循响应式流规则：Reactor是声明式流，不能通过“修改exchange后跳过返回”的方式终止流程，必须通过返回不同的Mono分支来控制请求走向。

• 提前预编译路径匹配的Pattern实例，避免每次请求都重新编译正则表达式。
• 如果配置不会频繁变更，可以对featureConfigService.getFeatures()的结果添加缓存（比如使用Reactor的cache()操作符），减少对外部配置服务的重复调用。

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