Feign接口报错java.lang.IllegalStateException: Body参数过多如何解决？

云上老周

2026-6-29

解决Feign客户端"Method has too many Body parameters"错误

问题原因

Feign默认会将没有注解修饰的方法参数都解析为请求体（Body），你的sendNotification方法中有两个无注解参数，导致Feign无法识别正确的参数类型，抛出"Method has too many Body parameters"异常。

解决方案

根据token的实际传递方式，给参数添加对应的Feign注解，同时明确标记请求体参数：

情况1：token作为请求头传递（最常见场景）

给token参数添加@RequestHeader注解，给NotificationRequest添加@RequestBody注解：

@FeignClient(name = "external-notifications")
public interface NotificationsClient {

    @PostMapping(value = "/", consumes = "application/json", produces = "application/json")
    Response sendNotification(@RequestHeader("Authorization") String token, @RequestBody NotificationRequest request);
}

注意：@RequestHeader括号内要填写实际的请求头名称，比如接口要求的token头是X-Token，就改成@RequestHeader("X-Token")。

情况2：token作为路径参数传递

如果接口路径是/{token}，给token添加@PathVariable注解：

@FeignClient(name = "external-notifications")
public interface NotificationsClient {

    @PostMapping(value = "/{token}", consumes = "application/json", produces = "application/json")
    Response sendNotification(@PathVariable("token") String token, @RequestBody NotificationRequest request);
}

情况3：token作为URL查询参数传递

如果token是通过?token=xxx的方式传递，给token添加@RequestParam注解：

@FeignClient(name = "external-notifications")
public interface NotificationsClient {

    @PostMapping(value = "/", consumes = "application/json", produces = "application/json")
    Response sendNotification(@RequestParam("token") String token, @RequestBody NotificationRequest request);
}