spring boot 处理 webflux 异常的核心做法是定义实现 webexceptionhandler 接口的 bean,并将其注册为最高优先级的组件。与传统的 servlet 栈不同,webflux 基于响应式流,异常通常作为错误信号在链中传递,因此需要拦截这些信号并转换为 http 响应。通过实现 handle() 方法,可以捕获如 responsestatusexception 或自定义的业务异常,并根据状态码返回相应的 json 或 html 内容。

如何区分并处理不同类型的异常
在处理 WebFlux 异常时,需要根据异常的具体类型(如参数校验失败、业务逻辑错误或系统未知错误)采取不同的响应策略。通常的做法是在 handle() 方法中使用 instanceof 或模式匹配来检查异常对象,从而决定返回的状态码和消息体。例如,MethodArgumentNotValidException 用于处理表单验证错误,而 ResponseStatusException 则用于处理已知的业务规则冲突。

import org.springframework.boot.web.reactive.error.ErrorWebExceptionHandler;
import org.springframework.core.annotation.Order;
import org.springframework.core.io.buffer.DataBuffer;
import org.springframework.http.HttpStatus;
import org.springframework.http.MediaType;
import org.springframework.stereotype.Component;
import org.springframework.web.server.ServerWebExchange;
import reactor.core.publisher.Mono;
import java.nio.charset.StandardCharsets;
@Component
@Order(-2) // 确保优先级高于默认处理器
public class GlobalWebExceptionHandler implements ErrorWebExceptionHandler {
@Override
public Mono<Void> handle(ServerWebExchange exchange, Throwable ex) {
ServerHttpResponse response = exchange.getResponse();
// 设置响应头
response.getHeaders().setContentType(MediaType.APPLICATION_JSON);
if (ex instanceof MethodArgumentNotValidException) {
response.setStatusCode(HttpStatus.BAD_REQUEST);
return writeErrorResponse(response, "参数校验失败");
} else if (ex instanceof ResponseStatusException) {
response.setStatusCode(((ResponseStatusException) ex).getStatusCode());
return writeErrorResponse(response, ex.getMessage());
} else {
response.setStatusCode(HttpStatus.INTERNAL_SERVER_ERROR);
return writeErrorResponse(response, "系统内部错误");
}
}
private Mono<Void> writeErrorResponse(ServerHttpResponse response, String message) {
String body = "{\"error\":\"" + message + "\",\"status\":" + response.getStatusCode().value() + "}";
DataBuffer buffer = response.bufferFactory().wrap(body.getBytes(StandardCharsets.UTF_8));
return response.writeWith(Mono.just(buffer));
}
}
如何处理全局未捕获的运行时异常
对于未在业务代码中显式抛出的运行时异常(如 NullPointerException 或 ArithmeticException),WebFlux 的全局异常处理器同样能够捕获。这是因为所有请求最终都会经过异常处理链,如果没有任何控制器或过滤器处理该异常,它将被传递给注册的 ErrorWebExceptionHandler。在这种情况下,通常返回 500 Internal Server Error 状态码,并记录日志以便排查问题,同时向客户端返回通用的错误提示以避免泄露敏感信息。

import org.springframework.boot.web.reactive.error.ErrorWebExceptionHandler;
import org.springframework.core.annotation.Order;
import org.springframework.core.io.buffer.DataBuffer;
import org.springframework.http.HttpStatus;
import org.springframework.http.MediaType;
import org.springframework.stereotype.Component;
import org.springframework.web.server.ServerWebExchange;
import reactor.core.publisher.Mono;
import java.nio.charset.StandardCharsets;
@Component
@Order(-2)
public class GlobalRuntimeExceptionHandler implements ErrorWebExceptionHandler {
@Override
public Mono<Void> handle(ServerWebExchange exchange, Throwable ex) {
// 这里可以添加日志记录逻辑
System.err.println("Unhandled exception: " + ex.getMessage());
ServerHttpResponse response = exchange.getResponse();
response.getHeaders().setContentType(MediaType.APPLICATION_JSON);
response.setStatusCode(HttpStatus.INTERNAL_SERVER_ERROR);
String body = "{\"error\":\"Internal Server Error\",\"status\":500}";
DataBuffer buffer = response.bufferFactory().wrap(body.getBytes(StandardCharsets.UTF_8));
return response.writeWith(Mono.just(buffer));
}
}
当异常发生在过滤器链中时如何处理
如果异常是在 Spring WebFlux 的过滤器链(Filter Chain)中抛出的,例如在自定义的认证过滤器中因令牌无效而抛出 UnauthorizedException,该异常同样会被全局异常处理器捕获。关键在于过滤器的执行顺序以及异常是否被正确传播。如果过滤器中使用了 Mono.error() 或抛出了异常,且未被后续的 onErrorResume 等算子处理,它将沿着响应式链向下传递,最终到达 ErrorWebExceptionHandler。因此,确保过滤器中的异常能够正确传播到全局处理器是实现统一异常处理的前提。


















