Spring Boot中Feign Client调用带元数据的文件上传接口报错415解决

问题原因 #

1. Feign默认编码器不支持multipart/form-data类型请求，无法正确处理MultipartFile和表单对象参数。
2. Feign不识别Spring的@ModelAttribute注解，导致元数据对象被错误拼接到URL参数中，而非作为表单字段传递。
3. 错误的参数注解搭配，使得请求媒体类型与服务端期望的multipart/form-data不匹配，触发415错误。

解决方案步骤 #

1. 添加Feign Multipart依赖

引入支持表单编码的Feign扩展依赖（版本适配你的Spring Cloud版本，示例对应Hoxton系列）：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
<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. 修改Feign Client接口

将参数注解替换为Feign支持的@RequestPart，确保文件和元数据都作为表单字段传递：

@FeignClient(name = "docsClient", url="<host_url>", configuration = DocsClientConfig.class)
public interface DocsClient {
    @PostMapping(value = "/v1/docs", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
    String uploadFile(@RequestPart("file") MultipartFile file, @RequestPart("metadata") MetaData metadata);
}

若元数据是零散字段，也可拆分为多个@RequestParam，例如：

String uploadFile(@RequestPart("file") MultipartFile file,
                  @RequestParam("title") String title,
                  @RequestParam("author") String author);

3. 配置Feign编码器

创建Feign配置类，指定使用SpringFormEncoder处理multipart/form-data请求：

@Configuration
public class DocsClientConfig {

    @Bean
    public Encoder feignEncoder() {
        return new SpringFormEncoder(new SpringEncoder(() -> new HttpMessageConverters(new MappingJackson2HttpMessageConverter())));
    }
}

4. 确保元数据类可序列化

MetaData类需要包含标准的getter/setter方法，确保Spring能正确将其序列化为表单字段：

public class MetaData {
    private String title;
    private String author;

    // getter和setter方法
    public String getTitle() { return title; }
    public void setTitle(String title) { this.title = title; }
    public String getAuthor() { return author; }
    public void setAuthor(String author) { this.author = author; }
}

验证说明 #

修改后，Feign会生成符合multipart/form-data规范的请求：

• 文件以二进制表单字段传递
• 元数据被编码为表单字段（或JSON格式，取决于编码器配置）
• 请求媒体类型与服务端期望一致，不会再触发415错误

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