SpringBoot FeignClient分页报错：方法Body参数过多如何解决？

问题场景 #

使用FeignClient实现分页查询时触发报错，提示方法包含过多Body参数。

错误信息 #

Method has too many Body parameters: public abstract org.springframework.http.ResponseEntity com.UserClient.getUserList(com.UserSearchDto,org.springframework.data.domain.Pageable)

对应FeignClient方法 #

@PostMapping("/user/getUserList")
ResponseEntity<Page<UserDto>> getUserList(@RequestBody UserSearchDto searchInputDto, Pageable page);

FeignClient配置类 #

@Component
public class FeignClientConfigInterceptor implements RequestInterceptor {

    @Bean
    public Encoder multipartFormEncoder() {
        return new SpringFormEncoder(new SpringEncoder(() -> new HttpMessageConverters(new RestTemplate().getMessageConverters())));
    }

    @Bean
    public ErrorDecoder errorDecoder() {
        return new RetreiveMessageErrorDecoder();
    }

    @Bean
    public Client feignClient() {
        return new ApacheHttpClient();
    }

    @Bean
    public Module pageJacksonModule() {
        return new PageJacksonModule();
    }

    @Bean
    public Module sortJacksonModule() {
        return new SortJacksonModule();
    }
}

问题原因 #

Feign默认不允许单个方法存在多个被解析为请求体的参数。此处Pageable参数未明确指定参数类型，会被Feign尝试当作请求体处理，加上已有的@RequestBody参数，就触发了"过多Body参数"的错误。

解决办法 #

有两种实用的处理方式：

方式一：将Pageable转为请求参数传递

修改FeignClient方法，给Pageable参数添加@SpringQueryMap注解，让它以URL查询参数的形式传递：

@PostMapping("/user/getUserList")
ResponseEntity<Page<UserDto>> getUserList(@RequestBody UserSearchDto searchInputDto, @SpringQueryMap Pageable page);

需确保服务端接口能正确接收分页相关查询参数（如page、size、sort等）。

方式二：合并参数到同一个DTO

创建整合查询条件与分页信息的新DTO，将原UserSearchDto和Pageable的字段合并，FeignClient方法仅接收该DTO作为请求体：

// 合并后的分页查询DTO
public class UserPageSearchDto {
    // 原UserSearchDto的查询字段
    private String username;
    private Integer status;
    // 分页相关字段
    private Integer page;
    private Integer size;
    private List<String> sort;
    
    // getter、setter方法省略
}

// 修改后的FeignClient方法
@PostMapping("/user/getUserList")
ResponseEntity<Page<UserDto>> getUserList(@RequestBody UserPageSearchDto searchDto);

这种方式需要服务端接口同步修改为接收该合并DTO。

额外注意事项

确认SpringFormEncoder的配置不会干扰参数解析逻辑，同时保证PageJacksonModule和SortJacksonModule配置正确，用于分页结果的序列化与反序列化。

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