在Spring Cloud Gateway中，全局通用异常处理是必不可少的，因为它能确保无论在任何情况下，网关都能提供统一、规范的响应。在传统的Spring Boot应用中，我们通常使用`@ControllerAdvice`注解来处理全局异常，但这种方法在微服务架构中并不适用，特别是在Spring Cloud Gateway这种基于WebFlux反应式编程的场景下。
Spring Cloud Gateway作为一个API网关，它负责路由转发和过滤器的执行。当网关尝试转发请求到下游服务时，可能会遇到各种异常情况，如服务不可达、网络错误等。在这种情况下，如果没有全局异常处理机制，客户端将直接收到原始的错误信息，这不仅不友好，也可能暴露内部系统的敏感信息。
默认情况下，Spring Cloud Gateway使用`ExceptionHandlingWebHandler`来处理异常。它会在所有过滤器链执行完成后捕获并处理未被捕获的异常。`ExceptionHandlingWebHandler`会遍历所有的`WebExceptionHandler`实例，找到合适的异常处理器来处理异常。其中，`DefaultErrorWebExceptionHandler`是默认的异常处理器，它根据客户端的`Accept`请求头来决定返回错误信息的方式，如HTML页面或JSON格式的数据。
为了自定义全局异常处理，我们可以创建自己的`ErrorWebExceptionHandler`，覆盖`handle`方法，从而在出现异常时返回自定义的响应。以下是一个简单的实现示例：
```java
@Component
public class CustomErrorWebExceptionHandler extends AbstractErrorWebExceptionHandler {
public CustomErrorWebExceptionHandler(ErrorAttributes errorAttributes) {
super(errorAttributes, new ResourceResolver());
}
@Override
protected RouterFunction<ServerResponse> getRoutingFunction(ErrorAttributes errorAttributes) {
return route()
.nest(path("/api"), this::apiErrorHandler)
.build();
}
private RouterFunction<ServerResponse> apiErrorHandler(NestedRouterFunction<ServerResponse> router) {
return router.route()
.nest(accept(MediaType.APPLICATION_JSON), this::jsonErrorHandler)
.nest(accept(MediaType.TEXT_HTML), this::htmlErrorHandler)
.build();
}
private ServerResponse jsonErrorHandler(RequestPredicate predicate, ServerRequest request) {
Map<String, Object> errorMap = getErrorAttributes(request, IncludeStacktrace.INCLUDE);
return ServerResponse.status(HttpStatus.INTERNAL_SERVER_ERROR)
.contentType(MediaType.APPLICATION_JSON)
.body(BodyInserters.fromValue(errorMap));
}
private ServerResponse htmlErrorHandler(RequestPredicate predicate, ServerRequest request) {
// 返回自定义的HTML错误页面
return ServerResponse.status(HttpStatus.INTERNAL_SERVER_ERROR)
.contentType(MediaType.TEXT_HTML)
.body(BodyInserters.fromValue("Sorry, something went wrong!"));
}
}
```
在这个例子中，`CustomErrorWebExceptionHandler`会根据请求的媒体类型（`Accept`头）来决定返回JSON格式的错误信息还是HTML错误页面。这样，我们就可以在网关层面为所有路由提供一致且友好的异常响应。
总结来说，Spring Cloud Gateway全局异常处理的实现是通过自定义`ErrorWebExceptionHandler`来完成的，它允许我们控制异常的处理方式，确保在各种异常情况下都能返回统一格式的响应。这对于提升系统的稳定性和用户体验至关重要。通过上述示例，我们可以看到如何创建一个自定义的异常处理器，并根据不同的请求类型返回不同的错误信息。这只是一个基础示例，实际应用中可以根据需求进一步定制错误处理逻辑，如记录日志、通知系统管理员等。
