WebFlux响应状态码无法修改，求助如何在提交前变更状态码

这个问题我在Spring WebFlux开发中也碰到过，核心原因就是你发现的——响应一旦被提交（COMMITTED），就再也没法修改状态码了。你当前的代码问题出在修改状态码的时机太晚，咱们换个正确的时机来处理就行。

正确思路：利用认证回调修改状态码 #

你继承的AuthenticationWebFilter本身就提供了认证成功和失败的专属回调方法，这些方法会在认证逻辑完成后立即触发，此时响应还没被后续流程提交，正好适合修改状态码。

修改你的CustomAuthenticationWebFilter代码：

class CustomAuthenticationWebFilter(securityContextRepository: ServerSecurityContextRepository) :
    AuthenticationWebFilter(securityContextRepository) {

    // 如果你是在认证失败时要返回UNAUTHORIZED，重写这个方法
    override fun onAuthenticationFailure(
        webFilterExchange: WebFilterExchange,
        exception: AuthenticationException
    ): Mono<Void> {
        // 此时响应未提交，可安全修改状态码
        webFilterExchange.exchange.response.statusCode = HttpStatus.UNAUTHORIZED
        
        // 可选：添加自定义响应体（比如返回错误信息）
        val response = webFilterExchange.exchange.response
        response.headers.contentType = MediaType.APPLICATION_JSON
        return response.writeWith(Mono.just(response.bufferFactory().wrap("{\"error\":\"认证失败，请检查凭证\"}".toByteArray())))
    }

    // 如果是认证成功时需要自定义状态码，重写这个方法
    override fun onAuthenticationSuccess(
        webFilterExchange: WebFilterExchange,
        authentication: Authentication
    ): Mono<Void> {
        webFilterExchange.exchange.response.statusCode = HttpStatus.OK // 替换成你需要的状态码
        return super.onAuthenticationSuccess(webFilterExchange, authentication)
    }
}

为什么原来的代码不生效？ #

你之前在super.filter(exchange, chain).doOnSuccess里修改状态码，这个时机是整个过滤链（包括授权、业务逻辑）执行完成之后，此时AbstractServerHttpResponse已经调用了doCommit方法，响应状态变为COMMITTED，自然无法再修改状态码。

而onAuthenticationFailure/onAuthenticationSuccess是在认证逻辑刚结束时触发的，后续流程还没开始处理响应，所以能成功修改状态码。

通用场景的备选方案 #

如果你的需求不是针对认证成功/失败，而是要在所有请求的响应提交前修改状态码，可以通过ServerHttpResponse的beforeCommit回调来实现：

override fun filter(exchange: ServerWebExchange, chain: WebFilterChain): Mono<Void> {
    // 给响应添加提交前的回调
    exchange.response.beforeCommit {
        Mono.fromRunnable {
            // 根据你的业务条件修改状态码
            if (需要修改状态码的条件) {
                exchange.response.statusCode = HttpStatus.UNAUTHORIZED
            }
        }
    }
    return super.filter(exchange, chain)
}

这个回调会在响应准备提交前执行，确保状态码的修改能生效。

内容的提问来源于stack exchange，提问作者Ricardo Romero Benítez