Feign调用不可用服务返回异常码0而非503问题排查

核心原因 #

当被调用服务全线下线时，异常是由Spring Cloud负载均衡组件（Spring Cloud LoadBalancer 或旧版Ribbon）在HTTP请求发起前抛出的（如NoAvailableServerException），此时Feign尚未生成实际的HTTP响应，自然无法触发仅处理HTTP错误码的ErrorDecoder。你看到的异常码0是负载均衡异常的标识，并非标准HTTP状态码。

解决方案 #

要让这种场景触发ErrorDecoder并执行重试，需要两步配置：将负载均衡异常转换为Feign可识别的HTTP错误，再配置重试逻辑。

1. 自定义负载均衡客户端，转换异常为503响应

实现Feign的Client接口，包装默认的负载均衡客户端，捕获无可用服务器的异常，构造503状态码的响应返回给Feign：

import feign.Client;
import feign.Request;
import feign.Response;
import org.springframework.cloud.loadbalancer.NoAvailableServerException;
import org.springframework.cloud.openfeign.loadbalancer.FeignBlockingLoadBalancerClient;
import org.springframework.stereotype.Component;

import java.io.IOException;

@Component
public class CustomLoadBalancerFeignClient implements Client {

    private final FeignBlockingLoadBalancerClient delegate;

    public CustomLoadBalancerFeignClient(FeignBlockingLoadBalancerClient delegate) {
        this.delegate = delegate;
    }

    @Override
    public Response execute(Request request, Request.Options options) throws IOException {
        try {
            return delegate.execute(request, options);
        } catch (NoAvailableServerException e) {
            // 将负载均衡异常转换为503 HTTP响应
            return Response.builder()
                    .status(503)
                    .reason("Service Unavailable")
                    .request(request)
                    .build();
        }
    }
}

2. 配置Feign的ErrorDecoder与重试策略

创建Feign配置类，注册自定义的ErrorDecoder（处理503异常并抛出可重试异常），同时配置重试策略：

import feign.Retryer;
import feign.codec.ErrorDecoder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class FeignConfig {

    // 注册自定义负载均衡客户端
    @Bean
    public Client feignClient(FeignBlockingLoadBalancerClient loadBalancerClient) {
        return new CustomLoadBalancerFeignClient(loadBalancerClient);
    }

    // 自定义ErrorDecoder，处理503异常
    @Bean
    public ErrorDecoder customErrorDecoder() {
        return (methodKey, response) -> {
            if (response.status() == 503) {
                // 抛出Feign的可重试异常，触发重试逻辑
                return new feign.RetryableException(
                        response.status(),
                        "服务不可用，触发重试",
                        response.request().httpMethod(),
                        null,
                        response.request()
                );
            }
            // 其他异常按默认逻辑处理
            return new feign.FeignException.ErrorStatusException(
                    response.status(),
                    response.reason(),
                    response.headers(),
                    response.body(),
                    response.request()
            );
        };
    }

    // 配置重试策略：初始间隔100ms，最大间隔1s，最多重试3次
    @Bean
    public Retryer feignRetryer() {
        return new Retryer.Default(100, 1000, 3);
    }
}

3. 开启Feign重试（可选配置）

在application.yml中添加配置，确保Feign重试功能生效：

feign:
  client:
    config:
      default:
        retryer: feign.Retryer.Default # 绑定自定义重试器
  retry:
    enabled: true # 开启Feign重试支持

注意事项 #

• 如果使用旧版Ribbon作为负载均衡组件，需要替换对应的客户端类（RibbonLoadBalancerClient），捕获的异常为com.netflix.client.ClientException（需判断异常类型或消息）。
• 若结合Spring Cloud CircuitBreaker使用，需确保断路器配置不会提前拦截重试逻辑。

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