Feign调用时ErrorDecoder未捕获SocketTimeoutException异常如何解决？

• ErrorDecoder触发逻辑限制：Feign的ErrorDecoder仅在服务端返回了有效HTTP响应且状态码非2xx时才会执行，SocketTimeoutException属于IO异常，发生时客户端未收到任何服务端响应，因此不会进入ErrorDecoder处理逻辑。
• UndeclaredThrowableException成因：该异常是JDK动态代理抛出的包装异常，本质原因是Feign调用过程中抛出的异常不属于Feign接口方法声明的可抛出异常范围。你配置的exceptionPropagationPolicy(UNWRAP)仅会解包Feign自身的包装异常，如果底层抛出的SocketTimeoutException或自定义异常是未声明的受检异常，仍然会触发该代理异常。

方案1：自定义Client包装层捕获IO异常（推荐） #

通过包装原有Feign Client，在请求执行层直接捕获超时等IO异常，转换为自定义异常抛出，代码示例：

public class CustomFeignClient implements Client {
    private final Client delegate;

    public CustomFeignClient(Client delegate) {
        this.delegate = delegate;
    }

    @Override
    public Response execute(Request request, Options options) throws IOException {
        try {
            return delegate.execute(request, options);
        } catch (SocketTimeoutException e) {
            // 直接抛出你自定义的业务异常
            throw new MyCustomException("ERROR_TIMEOUT", "Timeout Occurred: 读取超时");
        } catch (ConnectException e) {
            throw new MyCustomException("ERROR_CONNECT", "连接超时");
        }
    }
}

修改Feign Builder配置，替换client配置：

return Feign.builder()
        .logLevel(level)
        // 用自定义包装类包裹原有client
        .client(new CustomFeignClient(client))
        .retryer(Retryer.NEVER_RETRY)
        .options(options)
        .errorDecoder(feignErrorDecoder())
        .exceptionPropagationPolicy(UNWRAP)
        .build();

方案2：调整异常声明避免代理包装异常 #

如果你的MyCustomException属于受检异常，需要在所有Feign接口的方法签名上添加throws MyCustomException声明；直接将MyCustomException改为继承RuntimeException也可以避免声明，从根源上消除UndeclaredThrowableException。

方案3：外层切面统一处理 #

如果不想修改Feign相关配置，也可以在调用Feign接口的业务层添加统一异常切面，捕获UndeclaredThrowableException后解包getCause()，判断为超时异常时转换为自定义业务异常即可。

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