Feign接口方法中的throws声明无效，因Feign代理不检查或抛出声明的受检异常；真正异常处理依赖ErrorDecoder，它将HTTP错误响应转换为自定义异常并抛出。
在 OpenFeign 中，throws 关键字写在客户端接口方法签名里（比如 void doSomething() throws CustomException;）**不会自动触发异常转换，也不会被 Feign 运行时识别或处理**。它对 Feign 的实际行为没有影响——Feign 本身不检查、不抛出、也不传播你声明的受检异常。
为什么 throws 在 Feign 接口里基本无效
Feign 是基于动态代理 + JDK Proxy 或反射生成的代理对象，其方法调用最终由 InvocationHandler 拦截并转为 HTTP 请求。Feign 的设计原则是：所有远程调用失败统一走 FeignException（及其子类如 RetryableException），而不会将接口声明的 checked exception 自动包装或抛出。
即使你在接口中写 throws IOException, MyBusinessException，Feign 依然只可能抛出 FeignException 或运行时异常（如 RuntimeException），编译器也不会强制你捕获这些声明的异常（因为代理实现根本没抛它们）。
ErrorDecoder 是真正的异常解析入口
ErrorDecoder 是 Feign 提供的扩展点，用于**把 HTTP 响应（尤其是非 2xx 状态码）转换成你想要的 Java 异常**。它和 throws 声明无关，但却是你实现“业务异常语义”的唯一可靠方式。
立即学习“Java免费学习笔记（深入）”；
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- Feign 在收到响应后，若状态码不在
decoder配置的成功范围内（默认 200–399），就会调用ErrorDecoder.decode(methodKey, response) - 你在
decode()方法里解析响应体（如 JSON）、提取错误码/消息，然后 主动 new 并 throw 你自己的异常（比如CustomException） - 这个异常会穿透代理，最终抛给调用方 —— 此时调用方看到的就是你定义的异常类型，而非
FeignException
如何让 throws 声明“看起来”生效（配合 ErrorDecoder）
虽然 throws 不起作用，但你可以通过以下方式让接口契约更清晰，并与 ErrorDecoder 协同工作：
-
仅作为文档提示：在接口方法上用
throws CustomException表明“该接口约定可能抛出此异常”，提醒调用方关注错误处理逻辑 -
确保 ErrorDecoder 返回对应异常：在
decode()中，当识别到特定错误码（如 400 对应参数异常、404 对应资源不存在），就 new 并 throw 你声明的那个异常类型 -
避免声明受检异常：Feign 代理无法真正抛出 checked exception，建议统一用 运行时异常（
extends RuntimeException），否则调用方仍需 try-catch，但实际又捕不到 —— 容易造成误解
一个典型配合示例
假设你定义了业务异常：
public class UserNotFoundException extends RuntimeException { ... }
Feign 接口（throws 仅为语义提示）：
@FeignClient(name = "user-service")<br>public interface UserClient {<br> @GetMapping("/users/{id}")<br> User getUser(@PathVariable("id") Long id) throws UserNotFoundException;<br>}
自定义 ErrorDecoder：
public class UserErrorDecoder implements ErrorDecoder {<br> @Override<br> public Exception decode(String methodKey, Response response) {<br> try (Response.Body body = response.body()) {<br> if (response.status() == 404) {<br> return new UserNotFoundException("User not found");<br> } else if (response.status() == 400) {<br> // 解析 JSON body 获取具体原因<br> String msg = Util.toString(body.asReader(StandardCharsets.UTF_8));<br> return new IllegalArgumentException(msg);<br> }<br> } catch (IOException e) {<br> return new RuntimeException(e);<br> }<br> return new FeignException(response.status(), "Unknown error", response.request());<br> }<br>}
这样调用方就能自然地 catch (UserNotFoundException e)，而无需关心 Feign 底层细节。
