Spring Boot图片上传报错：Required request part 'file' is not present

你已经排除了Postman的问题，那咱们从Spring Cloud（Edgware版本）的配置、依赖和代码细节入手排查这个问题：

1. 检查Multipart自动配置是否生效 #

Spring Boot 1.5.x（对应你的Edgware版本）默认会启用Multipart支持，但在Spring Cloud微服务环境下，有时候需要显式配置来确保生效。在你的application.yml或application.properties中添加以下配置：

spring:
  http:
    multipart:
      enabled: true
      max-file-size: 10MB  # 根据你的需求调整大小
      max-request-size: 10MB

如果使用properties格式：

spring.http.multipart.enabled=true
spring.http.multipart.max-file-size=10MB
spring.http.multipart.max-request-size=10MB

2. Feign客户端的Multipart支持（关键！） #

你的POM里引入了spring-cloud-starter-feign，如果这个接口是通过Feign调用的，Feign默认不支持Multipart请求，必须额外配置：

第一步：添加Feign Form依赖 #

在POM中加入以下依赖（3.8.0版本适配Spring Cloud Edgware）：

<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>

第二步：配置Feign的Multipart Encoder #

创建一个Feign配置类：

@Configuration
public class FeignMultipartConfig {
    @Bean
    @Primary
    @Scope("prototype")
    public Encoder multipartFormEncoder() {
        return new SpringFormEncoder();
    }
}

第三步：修改Feign接口注解 #

Feign调用Multipart接口时，要用@RequestPart代替@RequestParam，并指定消费类型：

@FeignClient(name = "your-service-name", configuration = FeignMultipartConfig.class)
public interface ProfileImageFeignClient {
    @PostMapping(
        value = "/{account_id}/image",
        consumes = MediaType.MULTIPART_FORM_DATA_VALUE
    )
    ResponseEntity uploadProfileImage(
        @PathVariable("account_id") String accountId,
        @RequestPart("file") MultipartFile file
    );
}

3. 优化控制器注解 #

给你的控制器方法加上consumes属性，明确指定接收multipart/form-data类型的请求，避免类型匹配问题：

@RequestMapping(
    path = "/{account_id}/image",
    method = RequestMethod.POST,
    consumes = MediaType.MULTIPART_FORM_DATA_VALUE
)
public ResponseEntity uploadProfileImage(
    @RequestParam("file") MultipartFile file,
    @PathVariable String account_id
) {
    // 你的业务逻辑
}

4. 网关（如Zuul）的配置检查 #

如果你的服务前面有Zuul网关，需要确保网关允许大文件上传：

zuul:
  servlet-path: /
  host:
    max-request-size: 10MB
    max-socket-timeout-millis: 60000

同时网关本身也要配置spring.http.multipart的相关参数，和服务端的配置保持一致。

先从以上几点入手排查，尤其是Feign的配置，这是Spring Cloud环境下文件上传最容易踩坑的地方。

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