FeignBadResponse并非Spring Cloud Feign原生异常，实为自定义异常或误记；真实异常包括FeignClientException（4xx）、FeignServerException（5xx）及网络类异常；推荐通过自定义ErrorDecoder统一转换并捕获处理。
FeignBadResponse异常通常不是Spring Cloud Feign的原生异常类型——它并不存在于官方Feign或Spring Cloud OpenFeign的标准异常体系中。你可能实际遇到的是以下几种情况之一：
确认真实异常类型：常见Feign调用失败异常
Spring Cloud OpenFeign默认使用feign.codec.ErrorDecoder处理HTTP非2xx响应，抛出的是FeignException（其子类包括FeignClientException、FeignServerException）。如果你看到FeignBadResponse，很可能是项目中自定义的异常（比如封装了FeignException的业务异常），或是误记/拼写错误。
-
4xx响应 → 触发
FeignClientException -
5xx响应 → 触发
FeignServerException -
网络超时、连接拒绝等 → 抛出
RibbonTimeoutException（旧版）或ConnectException/SocketTimeoutException（新版，默认使用OkHttp或Apache HttpClient）
在catch块中正确捕获Feign异常
直接捕获FeignException可覆盖绝大多数HTTP错误响应场景。若需区分客户端与服务端错误，可分别捕获其子类：
try {
String result = someFeignClient.getData();
} catch (FeignClientException e) {
// 处理4xx，如400、401、404
int status = e.status();
String body = e.contentUTF8();
log.warn("Feign client error: {} {}", status, body);
} catch (FeignServerException e) {
// 处理5xx，如500、502、503
log.error("Feign server error: {}", e.getMessage(), e);
} catch (FeignException e) {
// 捕获其他Feign层面异常（如解码失败、空响应体）
log.error("Feign general error", e);
} catch (RuntimeException e) {
// 捕获底层IO异常（如ConnectException、SocketTimeoutException）
log.error("Feign network/runtime error", e);
}
自定义ErrorDecoder统一处理非2xx响应
更推荐的做法是全局统一处理，避免每个调用都写重复catch。通过实现ErrorDecoder，把HTTP错误响应转为业务可识别的异常（例如你的FeignBadResponse）：
立即学习“Java免费学习笔记（深入）”；
@Component
public class CustomErrorDecoder implements ErrorDecoder {
private final ErrorDecoder defaultDecoder = new Default();
@Override
public Exception decode(String methodKey, Response response) {
try {
if (response.status() >= 400 && response.status() < 500) {
return new FeignBadResponse("Client error: " + response.status(),
response.status(), response.body().toString());
} else if (response.status() >= 500) {
return new FeignBadResponse("Server error: " + response.status(),
response.status(), response.body().toString());
}
} catch (IOException ignored) {}
return defaultDecoder.decode(methodKey, response);
}
}
然后在Feign配置中启用：
@Configuration
public class FeignConfig {
@Bean
public ErrorDecoder errorDecoder() {
return new CustomErrorDecoder();
}
}
这样你就可以在catch中安全使用catch (FeignBadResponse e)了。
补充建议：日志与可观测性
Feign异常体内容（尤其是JSON）对排障至关重要，但默认可能被截断或未记录：
- 确保
response.body()被读取并记录（注意：body只能读一次，避免影响后续解码） - 使用
Logger或MDC记录traceId，关联调用链路 - 对敏感字段（如token、密码）做日志脱敏
