Spring Boot 3升级后OpenFeign v4中@FeignClient的name字段被追加到URL的问题求助

我最近把团队的服务升级到了Spring Boot 3，对应的OpenFeign也从v3版本升到了v4，结果遇到了一个棘手的问题——原来正常工作的@FeignClient现在会把name字段的值自动追加到配置的URL后面，导致所有相关测试都失败了。

给大家看一下我的Feign客户端定义：

@FeignClient(name = "my-client", url = "${my-client-api.url}")
public interface MyClient {

    @PostMapping
    MyResponse getInfo(@RequestHeader Map<String, String> headers,
                       @RequestBody InfoRequest infoRequest);
}

测试环境里my-client-api.url配置的是http://localhost:${wiremock.server.port}，在Spring Boot 2 + OpenFeign v3的时候，请求会正常发送到这个配置的URL；但升级后，实际请求的URL变成了http://localhost:${wiremock.server.port}/my-client，平白多了个my-client的后缀，完全不符合预期。

有没有大佬能帮忙解释下这到底是为啥，以及怎么解决这个问题呀？

问题原因分析 #

这其实是OpenFeign v4（适配Spring Boot 3的版本）的默认行为变更。在旧版本中，当你同时指定name和url时，name更多只是作为Feign客户端的标识，不会影响最终的请求路径；但在v4版本里，官方调整了这个逻辑——当你指定name后，它默认会被当作上下文路径（context path）追加到配置的url后面，这个调整是为了让name字段的语义在服务发现场景和直连URL场景下更统一，但也给升级带来了兼容性问题。

解决方案推荐 #

这里给两种可行的解决办法，根据你的实际场景选择：

1. 显式指定空路径，阻止自动追加
   在@FeignClient注解里加上path = ""，强制告诉Feign不要追加任何上下文路径：

   @FeignClient(name = "my-client", url = "${my-client-api.url}", path = "")
   public interface MyClient {
       // 原有方法定义保持不变
   }
   

2. 用contextId替代name作为客户端标识
   因为你已经指定了url，说明这个Feign客户端是直连指定地址，不需要依赖服务发现功能，这时候用contextId来替代name作为客户端的唯一标识就可以避免路径追加的问题：

   @FeignClient(contextId = "my-client", url = "${my-client-api.url}")
   public interface MyClient {
       // 原有方法定义保持不变
   }
   

   contextId的作用就是用来区分不同的Feign客户端，完全可以替代name在直连场景下的标识作用，同时不会触发路径追加的逻辑。

如果你的项目里还引入了Spring Cloud相关依赖，也可以检查下全局配置里有没有spring.cloud.openfeign.client.config.default.path这类可能影响路径的配置，但针对单个客户端的话，上面两种方案更直接有效。

备注：内容来源于stack exchange，提问作者mykola