FeignClient注解参数详解
@FeignClient 是 Spring Cloud 提供的声明式 HTTP 客户端注解，用于简化微服务间的调用。它通过接口 + 注解的方式定义远程 API，无需手写实现类。
常用参数说明：
- name / value：指定服务名称，结合注册中心（如 Eureka）用于服务发现。
- url：直接指定请求地址，常用于调试或无注册中心场景。
- path：为该客户端统一添加请求路径前缀。
- contextId：区分同一服务下的多个 FeignClient 实例，避免 Bean 冲突。
- configuration：指定配置类，可自定义编码器、解码器、日志级别、超时等。
- decode404：true 时将 404 响应交由解码器处理，否则抛异常。
- fallback：降级处理类，需实现当前接口并加 @Component。
- fallbackFactory：降级工厂类，可统一处理异常并返回不同的降级实现。
- primary / qualifier：用于多客户端实例的注入优先级与限定符。
示例：
@FeignClient(
name = "user-service",
path = "/api/users",
contextId = "userClientV1",
configuration = UserFeignConfig.class,
fallback = UserClientFallback.class
)
public interface UserClient {
@GetMapping("/{id}")
User getUserById(@PathVariable("id") Long id);
}
@Configuration
public class UserFeignConfig {
@Bean
public Request.Options options() {
return new Request.Options(5000, 10000); // 连接超时5s，读取超时10s
}
}
@Component
public class UserClientFallback implements UserClient {
@Override
public User getUserById(Long id) {
return new User(id, "default", "N/A");
}
}
使用建议：
- 配置隔离：configuration 类不要放在主应用扫描路径下，避免影响其他 FeignClient。
- 降级策略：推荐使用 fallbackFactory 获取异常信息，便于日志记录与分析。
- 超时设置：结合 Request.Options 与 Hystrix 超时配置，避免首次调用因懒加载超时。
- 路径冲突：避免在接口类上使用 @RequestMapping 与 Controller 路径重复导致 404，可直接在方法上定义完整路径。
通过合理配置 @FeignClient 参数，可以在微服务架构中实现高可用、可维护的服务间调用。
