Spring Cloud Feign 2020.0.4使用MultiValueMap调用multipart接口报500问题

Spring Cloud 2020.0.4对应Spring Cloud OpenFeign 3.0.x版本，对编码器逻辑做了改动：默认SpringEncoder检测到请求Content-Type为multipart/form-data时，会直接调用内置的SpringFormEncoder完成序列化，而旧版本Hoxton分支的Feign没有该逻辑，会直接使用通用的HttpMessageConverter完成表单序列化。
两个版本的序列化输出格式存在差异，而你调用的服务端基于Jersey实现（报错日志中可看到关联CamundaJerseyResourceConfig），对multipart表单的格式校验比较严格，无法兼容新版本编码器的输出格式，因此返回500错误。

可根据你的业务场景选择以下任意一种方案修复：

• 方案1：自定义编码器，沿用旧版本编码逻辑（改造成本最低，无业务侵入）
  自定义Feign编码器继承SpringEncoder，绕过新版本新增的multipart专属编码逻辑，代码示例如下：

  public class CustomSpringEncoder extends SpringEncoder {
      public CustomSpringEncoder(ObjectFactory<HttpMessageConverters> messageConverters) {
          super(messageConverters);
      }
  
      @Override
      public void encode(Object requestBody, Type bodyType, RequestTemplate request) throws EncodeException {
          // 直接调用父类通用编码逻辑，跳过multipart专属分支
          super.encode(requestBody, bodyType, request);
      }
  }
  

  将自定义编码器注入到Feign配置中：

  @Configuration
  public class FeignCustomConfig {
      @Bean
      public Encoder feignEncoder(ObjectFactory<HttpMessageConverters> messageConverters) {
          return new CustomSpringEncoder(messageConverters);
      }
  }
  

  最后在对应FeignClient注解上指定配置即可：

  @FeignClient(value = "目标服务名", configuration = FeignCustomConfig.class)
  public interface TestFeignClient {
      // 原有接口定义保持不变
  }
  

• 方案2：显式引入feign-form组件，使用标准表单编码器
  如果你的接口有文件上传需求，可引入官方表单编码组件适配multipart格式：
  1. 新增Maven依赖：

  <dependency>
      <groupId>io.github.openfeign.form</groupId>
      <artifactId>feign-form</artifactId>
      <version>3.8.0</version>
  </dependency>
  <dependency>
      <groupId>io.github.openfeign.form</groupId>
      <artifactId>feign-form-spring</artifactId>
      <version>3.8.0</version>
  </dependency>
  

  2. 配置表单编码器：

  @Bean
  public Encoder feignEncoder(ObjectFactory<HttpMessageConverters> messageConverters) {
      return new FormEncoder(new SpringEncoder(messageConverters));
  }
  

• 方案3：调整Content-Type类型（仅适用于无文件上传的场景）
  如果该接口仅传递普通表单字段，且服务端支持application/x-www-form-urlencoded格式，可直接修改接口注解的consumes属性：

  @PostMapping(value = "test", consumes = MediaType.APPLICATION_FORM_URLENCODED_VALUE)
  Response addVariable(MultiValueMap<String, Object> body);
  

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