feign调用不支持java受检异常透传，应统一返回200状态码+结构化错误体，由自定义errordecoder解析code非0响应并抛出runtimeexception子类异常，调用方直接try-catch捕获；熔断器需配置跳过业务异常处理。
feign调用本身不支持java受检异常（checked exception）的跨服务透传，因为http协议无法原样传递java异常对象。真正可行的做法是：**统一用200状态码返回结构化错误信息，再由feign通过自定义errordecoder解析并转为调用方可捕获的运行时异常**。
服务端：始终返回200 + 标准错误体
被调用方所有业务异常（如用户不存在、参数校验失败）都不要抛出异常后让框架返回4xx/5xx，而是主动包装成成功响应：
- HTTP状态码固定为200，避免触发Feign默认的ErrorDecoder（它只处理非200响应）
- 响应体为标准JSON，含
code（数字错误码）、message（提示语）、data（正常时为业务数据，异常时为null） - 示例：
{"code":40001,"message":"手机号已被注册","data":null} - 注意：该策略仅用于微服务间内部调用；面向前端的接口仍可保留4xx/5xx，通过请求头或路径区分调用来源
Feign端：自定义ErrorDecoder解析错误
编写实现ErrorDecoder的Bean，重点覆盖decode()方法，识别200响应中的错误码并抛出统一运行时异常：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 读取响应体，反序列化为通用结果类（如
R>），判断code != 0 - 构造自定义异常（如
ApiBusinessException），把code和message设为字段，便于下游提取 - 该异常必须继承
RuntimeException，否则调用方需强制try-catch，违背Spring生态习惯 - 在配置类中声明为
@Bean，Feign会自动全局生效（无需每个@FeignClient单独指定）
调用方：直接try-catch捕获业务异常
Feign接口方法签名无需throws声明，调用逻辑保持简洁：
try { userClient.getUser(123); } catch (ApiBusinessException e) { // 处理code=40001等具体业务错误 }- 异常对象中应携带完整错误上下文（如code、message、traceId），方便日志追踪和监控告警
- 可配合
@RestControllerAdvice做全局异常统一格式封装，但仅限于本服务对外输出，不影响Feign内部透传逻辑
避坑提醒：别混淆熔断与业务异常
如果项目启用了Hystrix或Resilience4j熔断，需注意：
- Hystrix默认会吞掉
RuntimeException子类（包括你自定义的ApiBusinessException），导致业务异常被误判为服务不可用 - 解决办法：将业务异常改为继承
HystrixBadRequestException，这样熔断器会跳过降级，直接向上抛出 - 或者关闭熔断对业务异常的拦截——在
@FeignClient(fallback = ...)中，fallback逻辑只处理连接超时、服务宕机等系统级故障
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
