spring boot 全局异常处理无法直接捕获服务降级异常,因为 feign 客户端在触发降级逻辑时不会抛出异常,而是返回降级器(fallback)提供的默认值或空对象。要捕获并处理这些情况,必须在调用 feign 客户端后,显式检查返回结果的状态码、错误标志位或特定字段,并在发现异常数据时手动抛出业务异常,从而交由 @restcontrolleradvice 统一处理。

Feign 降级机制为何不抛出异常
Feign 的降级功能通过 fallbackFactory 实现,当远程调用失败(如超时、网络中断)时,Feign 会拦截异常并转而执行降级类中的方法。降级方法通常返回一个静态的、安全的响应对象,例如包含 code: -1 和 message: "服务不可用" 的 JSON 结构。由于降级方法本身是正常执行的 Java 方法调用,它不会向上传播任何异常堆栈,因此 @ExceptionHandler 永远无法捕获到“降级”这一动作。开发者需要关注的是降级后的返回值是否符合预期。

package com.example.demo.controller;
import com.example.demo.client.UserClient;
import com.example.demo.dto.ResponseDTO;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class UserController {
private final UserClient userClient;
public UserController(UserClient userClient) {
this.userClient = userClient;
}
@GetMapping("/user/info")
public ResponseDTO getUserInfo() {
// 调用 Feign 客户端
ResponseDTO result = userClient.getUser();
// 显式检查降级返回的错误状态
if (result.getCode() != null && result.getCode() == -1) {
// 手动抛出异常,交由全局处理器捕获
throw new RuntimeException("用户服务降级: " + result.getMessage());
}
return result;
}
}上述代码中,getUser() 调用成功后,程序继续执行。如果发生了降级,result.getCode() 将等于 -1。此时通过 throw new RuntimeException(...) 主动抛出异常,该异常会被 Spring MVC 的全局异常处理器捕获。这种模式确保了无论远程调用成功还是降级失败,前端都能收到统一的异常格式响应,而不是一个静默失败的降级对象。
如何在全局异常处理器中区分降级异常
为了在前端或日志中明确标识出这是由服务降级引起的错误,需要定义一个专门的自定义异常类,例如 ServiceDowngradeException。在 Controller 层检测到降级特征后,抛出该特定异常。在全局异常处理类中,使用 @ExceptionHandler(ServiceDowngradeException.class) 单独处理这种情况,返回特定的 HTTP 状态码(如 503 Service Unavailable)和友好的提示信息。

package com.example.demo.exception;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import com.example.demo.dto.ResponseDTO;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(ServiceDowngradeException.class)
public ResponseDTO handleServiceDowngrade(ServiceDowngradeException e) {
// 记录日志
System.err.println("服务降级被捕获: " + e.getMessage());
// 返回特定的降级响应结构
return ResponseDTO.error(503, "当前服务繁忙,请稍后重试");
}
@ExceptionHandler(Exception.class)
public ResponseDTO handleOtherExceptions(Exception e) {
return ResponseDTO.error(500, "系统内部错误");
}
}在 Controller 中,将之前抛出的 RuntimeException 替换为 ServiceDowngradeException。这样,全局处理器就能精准识别出哪些错误源于服务降级,哪些源于其他业务逻辑错误。对于降级场景,返回 503 状态码更符合语义,提示客户端暂时不要重试或进行熔断保护。同时,确保 ResponseDTO 是一个标准的 JSON 结构,包含 code、message 和 data 字段,以便前端统一解析。
基于返回码 -1 的具体判断逻辑
在实际开发中,降级返回的具体字段值取决于 FallbackFactory 的实现。假设降级工厂返回的 ResponseDTO 中,code 字段固定为 -1,而 data 字段为 null。Controller 中必须严格判断 result.getCode().equals(-1)。如果降级逻辑修改了返回码,例如改为 0 表示未知错误,则判断条件需相应调整。此外,若降级方法直接抛出异常而非返回错误对象,则 Feign 会重新抛出该异常,此时 @ExceptionHandler 可直接捕获,无需手动检查。但标准做法是返回错误对象,以保持接口契约的一致性。


















