Spring Cloud Gateway自定义POST过滤器调用WebClient挂起及响应体修改问题
WebClient请求挂起的直接原因
Spring WebFlux 中ServerHttpRequest的请求体是单播的Flux<DataBuffer>流,一旦被网关内置的路由过滤器(NettyRoutingFilter)订阅读取、转发给下游服务后,整个流就会被消费耗尽。你在WebClient请求里直接订阅原始exchange.request.body作为请求体时,根本读不到任何数据,WebClient发完请求头后会一直等待请求体数据到达,最终卡在request_sent状态永远无法完成请求。
你代码里写的doOnNext{ cache(...) }缓存逻辑完全无效——因为流已经被提前消费,这个回调根本不会触发。响应修改不生效的根本原因
你当前的逻辑是等chain.filter(exchange)完全执行完后,再去写自定义响应。但chain.filter流程走完的标志,就是网关内置的路由过滤器已经把下游代理的响应(也就是/thisFirst接口的返回)直接提交给客户端了,HTTP响应的状态码、响应头、响应体都已经发送完毕,连接处于即将关闭的状态。这时候再调用writeWith写内容,会触发Response already committed异常,根本无法修改返回给客户端的内容。配置不匹配的连带问题
你的Params类定义的字段是urlPath,但yml配置里传的参数key是proxyBasePath,参数无法正确注入,WebClient实际请求的目标地址和你预期的http://localhost:9000/thisSecond不一致。
第一步:解决请求体重复读取的问题
使用Spring Cloud Gateway内置的ServerWebExchangeUtils.cacheRequestBody在过滤器入口提前缓存请求体,生成可重复读取的请求副本,避免流被消费后读不到数据。
第二步:调整执行顺序,拦截提前提交的响应
不要让网关内置的路由逻辑直接把响应写给客户端,拦截原响应的输出,等拿到WebClient请求的返回后,再统一把自定义响应写给客户端。
第三步:修正参数绑定逻辑
保证yml配置的args key和Params类的字段名完全一致,让WebClient的目标地址能正确注入。
class PostProxyGatewayFilterFactory : AbstractGatewayFilterFactory<PostProxyGatewayFilterFactory.Params>(Params::class.java) { override fun apply(params: Params): GatewayFilter { return GatewayFilter { exchange, chain -> // 提前缓存请求体,生成可重复读的交换器 ServerWebExchangeUtils.cacheRequestBody(exchange) { cachedExchange -> // 拦截原响应,防止提前提交给客户端 val wrappedResponse = object : ServerHttpResponseDecorator(cachedExchange.response) { override fun writeWith(body: Flux<DataBuffer>): Mono<Void> { // 直接丢弃原/thisFirst接口的响应内容,不实际写给客户端 return body.then() } } val mutatedExchange = cachedExchange.mutate().response(wrappedResponse).build() // 执行原网关路由流程(完成/thisFirst接口的代理调用) chain.filter(mutatedExchange) .then( // 等原代理流程成功后,发起独立的WebClient请求到/thisSecond executeRequest(mutatedExchange, params) .flatMap { responseEntity -> writeCustomResponse(mutatedExchange, responseEntity) } ) } } } data class Params( val urlPath: String = "" // 必须和yml配置的key完全匹配 ) private fun executeRequest(exchange: ServerWebExchange, params: Params): Mono<ResponseEntity<JsonNode>> { // 从缓存的交换器中获取可重复读的请求体流 val cachedBody = ServerWebExchangeUtils.getCachedRequestBody(exchange) val requestSpec = when(exchange.request.method) { HttpMethod.POST, HttpMethod.PUT -> { WebClient.create() .method(exchange.request.method!!) .uri(params.urlPath) .body(BodyInserters.fromDataBuffers(cachedBody)) } HttpMethod.GET, HttpMethod.DELETE -> { WebClient.create() .method(exchange.request.method!!) .uri(params.urlPath) } else -> throw IllegalArgumentException("不支持的请求方法") } return requestSpec.headers { headers -> // 拷贝原始请求头,跳过自动计算的头避免冲突 exchange.request.headers.forEach { (key, value) -> if (key != HttpHeaders.HOST && key != HttpHeaders.CONTENT_LENGTH) { headers.addAll(key, value) } } }.exchange() .flatMap { it.toEntity(JsonNode::class.java) } } private fun writeCustomResponse(exchange: ServerWebExchange, responseEntity: ResponseEntity<JsonNode>): Mono<Void> { // 同步响应状态码 exchange.response.statusCode = responseEntity.statusCode // 同步响应头 responseEntity.headers.forEach { (key, value) -> exchange.response.headers.putAll(key, value) } // 写入响应体 val responseContent = responseEntity.body?.toString() ?: "" val dataBuffer = exchange.response.bufferFactory().wrap(responseContent.toByteArray(Charsets.UTF_8)) return exchange.response.writeWith(Flux.just(dataBuffer)) } }
- 缺少响应元数据同步:只写响应体,没有把WebClient返回的状态码、响应头同步到客户端响应上,导致响应信息不完整
- 响应提交流程冲突:没有拦截原网关的提前响应,调用
writeWith时会触发响应已提交的异常 - 没有处理
DataBuffer的释放逻辑,长期运行可能出现内存泄漏
配置文件需要同步修正参数key,保证和Params字段匹配:
filters: - name: PostProxy args: urlPath: http://localhost:9000/thisSecond # 和Params字段名完全一致
内容的提问来源于stack exchange,提问作者Addison Joseph

