Resilience4j CircuitBreaker如何设置fallback返回与原方法不同类型的结果

报错根因 #

Resilience4j的熔断降级方法要求返回值类型必须与原接口方法的返回类型兼容（即相同或是其子类），你原方法返回ResponseModelEmployee类型，期望的fallback返回String类型，两者无继承关系，框架无法匹配到符合要求的降级方法，因此抛出NoSuchMethodException。

可行解决方案 #

方案1：给ResponseModelEmployee扩展错误提示字段（最推荐） #

这是符合接口规范的最优方案，在原有ResponseModelEmployee类中新增状态码、错误提示两个通用字段：

public class ResponseModelEmployee {
    // 原有字段全部保留
    private Integer code;
    private String message;
    // 原有getter/setter保留，新增对应字段的getter/setter
}

正常请求时给code赋值200，message赋值"操作成功"，正常填充业务字段即可；降级方法修改为：

public ResponseModelEmployee employeeFallback(Long id, Exception ex) {
    ResponseModelEmployee res = new ResponseModelEmployee();
    res.setCode(503);
    res.setMessage("Branch Service is down");
    return res;
}

前端可以根据code判断接口状态，获取对应提示。

方案2：使用ResponseEntity<?>作为统一返回类型 #

如果不想修改原有ResponseModelEmployee的结构，可以直接调整控制器方法的返回类型为通配泛型的ResponseEntity，兼容两种返回值：
修改控制器原方法：

@GetMapping("/getById/{id}")
@CircuitBreaker(name = "default", fallbackMethod = "employeeFallback")
public ResponseEntity<?> getEmployee(@PathVariable("id") Long id) {
    return ResponseEntity.ok(employeeService.findByEmployeeId(id));
}

修改fallback方法：

public ResponseEntity<?> employeeFallback(Long id, Exception ex) {
    return ResponseEntity.status(HttpStatus.SERVICE_UNAVAILABLE).body("Branch Service is down");
}

服务正常时会返回200状态码和ResponseModelEmployee格式的JSON，熔断时返回503状态码和错误提示字符串，完全符合你的需求。

方案3：直接设置返回类型为Object #

最简单但规范性稍差的方案，直接将原方法返回类型改为Object：

@GetMapping("/getById/{id}")
@CircuitBreaker(name = "default", fallbackMethod = "employeeFallback")
public Object getEmployee(@PathVariable("id") Long id) {
    return employeeService.findByEmployeeId(id);
}

fallback方法保持你期望的写法即可，Spring MVC会自动根据返回值类型序列化对应格式的响应。

内容的提问来源于stack exchange，提问作者Sumon Bappi