spring boot 全局异常处理无法直接捕获 gateway 路由异常,因为 gateway 是独立进程,其异常由自身的 errorwebexceptionhandler 拦截。要统一处理,需在 gateway 中配置全局错误处理器将异常转换为标准 json 响应,并在业务服务中通过 feign 或 resttemplate 的 errordecoder 解析该响应并抛出对应异常。

Gateway 如何自定义全局异常响应
在 Gateway 项目中实现 ErrorWebExceptionHandler 接口并重写 handle 方法,可以拦截所有未处理的异常并将其序列化为统一的 JSON 格式返回给客户端。

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;
import java.util.HashMap;
import java.util.Map;
@Order(-1)
@Component
public class GlobalErrorWebExceptionHandler implements ErrorWebExceptionHandler {
@Override
public Mono<void> handle(ServerWebExchange exchange, Throwable ex) {
HttpStatus status = HttpStatus.INTERNAL_SERVER_ERROR;
if (ex instanceof org.springframework.cloud.gateway.support.NotFoundException) {
status = HttpStatus.NOT_FOUND;
}
Map<string object> body = new HashMap();
body.put("status", status.value());
body.put("message", ex.getMessage());
byte[] bytes = body.toString().getBytes(StandardCharsets.UTF_8);
DataBuffer buffer = exchange.getResponse().bufferFactory().wrap(bytes);
exchange.getResponse().getHeaders().setContentType(MediaType.APPLICATION_JSON);
return exchange.getResponse().writeWith(Mono.just(buffer));
}
}</string></void>
Feign 客户端如何解析网关错误响应
在业务服务中配置 ErrorDecoder,当收到非 2xx 状态码时,读取响应体中的 JSON 信息并抛出自定义异常,从而让业务层的 @ControllerAdvice 能够捕获。

import feign.Response;
import feign.codec.ErrorDecoder;
import org.springframework.http.HttpStatus;
import java.io.IOException;
import java.util.Map;
public class CustomErrorDecoder implements ErrorDecoder {
private final ErrorDecoder defaultDecoder = new Default();
@Override
public Exception decode(String methodKey, Response response) {
try {
String body = Util.toString(response.body().asReader(), StandardCharsets.UTF_8);
// 假设 body 是 {"status":404,"message":"Not Found"}
// 实际需使用 Jackson 或 Gson 解析
throw new RuntimeException("Gateway Error: " + body);
} catch (IOException e) {
return defaultDecoder.decode(methodKey, response);
}
}
}
如何处理 404 路由未找到异常
当请求的路径在服务端不存在时,Gateway 会抛出 NotFoundException,上述全局异常处理器会将其转换为 404 状态的 JSON 响应,业务服务通过 ErrorDecoder 捕获后向上抛出,最终由业务层的全局异常处理器统一返回前端友好的错误页面或提示。











