Spring Boot中spring.http.multipart.enabled禁用配置不生效求助

核心原因：配置键与Spring Boot版本不匹配 #

你当前使用的spring.http.multipart.enabled=false是Spring Boot 1.x版本的配置键，而在Spring Boot 2.x及以上版本中，Multipart相关配置已迁移到servlet节点下，原配置键不再生效——这就是端口和上下文路径正常生效、仅Multipart配置无效的关键原因。

具体解决步骤 #

1. 修改配置键适配当前Spring Boot版本 #

将YAML配置中的Multipart禁用项替换为对应版本的正确配置：

spring:
  servlet:
    multipart:
      enabled: false
server:
  servlet:
    context-path: /content
  port: 9080

2. 彻底排除Spring的Multipart自动配置 #

仅修改配置可能无法完全禁用自动配置类，需手动排除MultipartAutoConfiguration：

• 方式一：在启动类上添加排除注解

@SpringBootApplication(exclude = MultipartAutoConfiguration.class)
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

• 方式二：在YAML配置中添加自动配置排除项

spring:
  autoconfigure:
    exclude: org.springframework.boot.autoconfigure.web.servlet.MultipartAutoConfiguration
  servlet:
    multipart:
      enabled: false

3. 确保Apache Commons FileUpload依赖正确引入 #

在你的构建文件中添加对应依赖：

Maven：

<dependency>
    <groupId>commons-fileupload</groupId>
    <artifactId>commons-fileupload</artifactId>
    <version>1.5</version>
</dependency>

Gradle：

implementation 'commons-fileupload:commons-fileupload:1.5'

4. 验证配置与实现 #

启动应用后，可通过以下方式验证：

• 检查日志，确认MultipartAutoConfiguration未被加载（排除后不应出现相关日志）
• 直接使用Commons FileUpload的API处理请求，示例代码：

@RequestMapping(value = "/upload", method = RequestMethod.POST)
public ResponseEntity<String> handleFileUpload(HttpServletRequest request) throws Exception {
    if (!ServletFileUpload.isMultipartContent(request)) {
        return ResponseEntity.badRequest().body("请求不是multipart类型");
    }

    DiskFileItemFactory factory = new DiskFileItemFactory();
    ServletFileUpload upload = new ServletFileUpload(factory);
    List<FileItem> fileItems = upload.parseRequest(request);

    for (FileItem item : fileItems) {
        if (!item.isFormField()) {
            // 直接读取文件流，无需临时存储
            try (InputStream inputStream = item.getInputStream()) {
                // 你的文件处理逻辑
                System.out.println("处理文件：" + item.getName());
            }
        }
    }
    return ResponseEntity.ok("文件上传处理完成");
}

额外排查点 #

• 检查是否存在其他环境配置文件（如application-dev.yml）覆盖了当前Multipart设置
• 确认系统环境变量、启动参数中没有优先级更高的Multipart启用配置

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