FeignClient请求前缀在哪里

### 设置或修改 Spring Cloud FeignClient 请求前缀

在 Spring Cloud 中，`FeignClient` 的请求路径可以通过多种方式进行配置和调整。为了设置或修改 `FeignClient` 的请求前缀，有几种不同的方法可供选择。

#### 方法一：使用 `path` 属性
可以在 `@FeignClient` 注解中直接指定 `path` 属性来为整个客户端添加公共前缀。这种方式适用于所有该客户端发起的 HTTP 请求[^1]：

@FeignClient(name = "order-server", path = "/api/v1")
public interface OrderRemoteClient {
    @GetMapping("/orders/{id}")
    public Order getOrderById(@PathVariable("id") Long id);
}

上述例子中的 `/api/v1` 将作为此接口下所有 API 调用的基础 URL 前缀。

#### 方法二：通过配置文件自定义 Base Path
另一种更为灵活的方法是在应用程序外部化配置（如 application.yml 或者 properties 文件）里设定基础路径，并利用占位符 `${}` 来引用这些变量值。这允许动态改变服务端点而无需重新编译代码[^3]:

feign:
  client:
    config:
      order-service:
        url: http://localhost:8080/api/v2/

接着，在相应的 `@FeignClient` 上不需再显式指明 `url` 参数，因为已经由全局配置提供默认行为:

@FeignClient(name = "order-service")
public interface OrderServiceClient {
    @GetMapping("/orders/{id}")
    public Order fetchOrderDetails(@PathVariable("id") Long id);
}

这里假设所有的针对 `order-service` 发起的请求都会自动带上 `/api/v2/` 这个前缀部分。

#### 方法三：结合 `@RequestMapping` 使用
对于更复杂的场景，比如不同版本的服务共存于同一个微服务体系内，则可以考虑采用组合策略——即同时运用 `@FeignClient(path)` 和 `@RequestMapping` (或其他映射注解)，从而实现更加精细控制每个具体操作所携带的不同层次结构的 URI 片段[^4] :

@FeignClient(name = "product-catalogue", path="/v1/products")
@RequestMapping("/search")
public interface ProductSearchClient {

    @PostMapping("")
    List<Product> searchProducts(@RequestBody SearchCriteria criteria);

    @GetMapping("/{productId}")
    Product getProductInfo(@PathVariable("productId") String productId);
}

在这个案例里面，最终构建出来的完整 URL 可能会像这样子:`http(s)://host[:port]/v1/products/search`.