Feign Client是否支持可选请求参数？代码场景下的实现疑问

开发者阿泽

2026-5-14

Feign Client可选请求参数的实现方案

当然支持可选请求参数啦！你遇到的问题主要是Feign对可选参数的处理逻辑和Spring MVC略有差异，我给你分享几种实用的实现方法：

方法一：直接声明可选参数（最贴近你的写法）

你可以在Feign接口中直接沿用类似Spring MVC的写法，设置required = false和defaultValue，Feign是支持这种配置的：

@FeignClient(name = "target-service")
public interface YourFeignClient {
    @GetMapping(path = "endpoint1")
    ResponseEntity<String> request(
        @RequestParam(name = "param1", required = false, defaultValue = "key") String param1
    );
}

这里需要注意两个细节：

如果你调用时传入null，Feign默认不会把这个参数添加到请求URL中；
如果希望不传参数时自动使用默认值，调用时要么不传这个参数（比如写重载方法），要么确保传入的不是null（比如用Optional包装后做非空处理）。

方法二：使用Map传递动态参数（适合多可选参数场景）

如果有多个可选参数，用Map来传递会更灵活，Feign会自动把Map中的键值对作为请求参数，没添加的参数就不会出现在请求里：

@FeignClient(name = "target-service")
public interface YourFeignClient {
    @GetMapping(path = "endpoint1")
    ResponseEntity<String> request(@RequestParam Map<String, String> params);
}

调用的时候只需要把需要的参数放进Map就行：

Map<String, String> params = new HashMap<>();
// 只在需要的时候添加param1
if (needParam1) {
    params.put("param1", "custom-value");
}
yourFeignClient.request(params);