spring boot 的全局异常处理机制无法直接捕获边车代理(如 envoy、istio)产生的异常,因为边车代理运行在应用进程之外,其拦截到的错误通常以 http 状态码或 grpc 状态的形式返回给客户端,而不是作为 java 异常抛出。要处理这类问题,需要在 spring boot 应用中通过自定义的 `resttemplate` 或 `webclient` 配置全局的错误解码器,或者在网关层统一处理这些非 2xx 的响应,将其转换为业务层可理解的异常对象。

为什么全局异常处理器抓不到边车代理的错误
全局异常处理器(如 `@ControllerAdvice`)只能捕获由 Spring MVC 或 WebFlux 内部抛出的 Java 异常。当请求经过边车代理时,如果代理因超时、连接拒绝或服务不可用而拒绝请求,它通常会直接向客户端返回一个 HTTP 错误(如 503 Service Unavailable)或 gRPC 错误。这个错误发生在网络传输层,根本不会进入 Spring Boot 应用的控制器逻辑,因此 `@ExceptionHandler` 永远无法触发。开发者常误以为可以在应用内统一处理所有上游错误,但实际上必须区分“应用内部异常”和“外部通信异常”。

import org.springframework.web.client.RestClientException;
import org.springframework.web.client.RestTemplate;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
public class SidecarErrorHandler {
public static void main(String[] args) {
RestTemplate restTemplate = new RestTemplate();
try {
// 模拟调用被边车代理拦截的服务
ResponseEntity<string> response = restTemplate.getForEntity(
"http://upstream-service/api/data", String.class);
} catch (RestClientException e) {
// 这里可以捕获到边车代理返回的非成功状态码导致的异常
System.out.println("Caught sidecar error: " + e.getMessage());
}
}
}</string>
如何在 Feign 客户端中统一处理边车代理返回的错误
在使用 OpenFeign 等声明式 HTTP 客户端时,可以通过实现 `ErrorDecoder` 接口来捕获边车代理返回的错误信息。当边车代理返回 4xx 或 5xx 状态码时,Feign 会默认抛出 `FeignException`。通过在 `ErrorDecoder` 中检查状态码,可以将特定的边车代理错误(如 503)转换为自定义的业务异常,从而让全局异常处理器能够捕获并统一响应。

import feign.Response;
import feign.codec.ErrorDecoder;
import org.springframework.stereotype.Component;
@Component
public class CustomSidecarErrorDecoder implements ErrorDecoder {
@Override
public Exception decode(String methodKey, Response response) {
if (response.status() == 503) {
return new SidecarProxyException("Service unavailable via sidecar");
}
return new Default().decode(methodKey, response);
}
}
class SidecarProxyException extends RuntimeException {
public SidecarProxyException(String message) {
super(message);
}
}
如何验证自定义异常是否被全局处理器正确捕获
为了验证上述方案的有效性,需要确保自定义的 `SidecarProxyException` 被 `@ControllerAdvice` 中的 `@ExceptionHandler` 捕获。在全局异常处理器中,针对该自定义异常编写处理逻辑,返回统一的 JSON 格式错误响应。这样,无论错误是来自应用内部还是边车代理,客户端都能收到一致的结构化错误信息,便于前端或调用方进行统一解析和处理。











