使用FeignClient的value与name属性是否存在差异？

一、@FeignClient 的常见使用方式 #

• 指定value属性：

@FeignClient(value = "jplaceholder", url = "https://jsonplaceholder.typicode.com/")
public interface JSONPlaceHolderClient {
}

• 指定name属性或直接传入参数（直接传参等价于设置value/name）：

@FeignClient("stores")
public interface StoreClient {
}

@FeignClient(name = "stores", configuration = FooConfiguration.class)
public interface StoreClient {
}

二、从源码看属性关系 #

查看@FeignClient注解源码可知，value和name互为别名：

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
public @interface FeignClient {
    @AliasFor("name")
    String value() default "";

    @AliasFor("value")
    String name() default "";
}

三、value 与 name 的实际差异 #

在Spring框架中，@AliasFor注解的作用是将两个属性标记为互为别名，这意味着：

• 使用value或name设置服务名称，在功能上完全等价，没有任何差异
• 直接传入参数（如@FeignClient("stores")）本质是给value属性赋值，由于别名关系，等同于给name赋值

四、问题排查建议 #

既然两者功能一致，若使用Feign时遇到问题，可从以下方向排查：

• 检查服务名称是否与注册中心的服务名完全匹配（注意大小写、特殊字符）
• 确认Feign客户端的配置类是否正确生效（如configuration属性指定的配置是否被加载）
• 验证服务端是否正常注册到注册中心，网络连通性是否正常
• 查看Feign的日志输出（调整日志级别至DEBUG），排查请求发送过程中的异常

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