`Resolved [org.springframework.web.HttpMediaTypeNotSupportedException: Content type 'multipart/form-data;boundary=---']` 是一个常见的 Spring Web 异常信息，它表明服务器无法处理客户端发送的 `Content-Type` 类型请求。下面我们将详细分析这个问题的原因及其解决方法。 --- ### **异常解读** 1. **异常来源** - 这个错误是由 Spring 框架抛出的，属于 `HttpMediaTypeNotSupportedException` 类。 - 错误的核心原因在于客户端发送的 HTTP 请求头中包含了一个不被服务器支持的 `Content-Type` 内容类型。 2. **关键点** - 报错内容明确指出了问题所在：`Content type 'multipart/form-data;boundary=---'`。 - 客户端试图向服务器发送一个多部分表单数据 (`multipart/form-data`)，但是服务器并未配置好如何处理这类媒体类型。 --- ### **为什么会发生这种情况？** 1. **控制器未正确定义处理逻辑** - 如果你在 Controller 中没有正确声明对 `multipart/form-data` 的支持，Spring 会默认认为你不允许此类请求进入。 - 典型例子是没有使用 `@RequestParam("file") MultipartFile file` 来绑定上传文件。 2. **缺少必要的依赖项** - 处理文件上传需要额外的支持库（例如 Apache Commons FileUpload 或者 Servlet API），如果没有引入这些依赖，Spring 就不会具备解析 multipart 数据的能力。 3. **全局配置缺失** - 即便 Controller 层已准备好接收文件流，但如果项目层面没有启用文件上传相关的功能（如设置最大大小限制等），仍然会出现这样的报错。 4. **边界符冲突** - 虽然这里的边界符 `boundary=---` 很可能是占位符或截断后的简化版本，但在某些特殊情况下，不当生成的 boundary 字段也可能引发兼容性问题。 --- ### **解决方案** #### 方案一：检查并修正 Controller 方法 确保你的方法能正确处理 `multipart/form-data` 格式的请求： ```java @RestController @RequestMapping("/upload") public class UploadController { @PostMapping(consumes = MediaType.MULTIPART_FORM_DATA_VALUE) public ResponseEntity<String> handleFileUpload(@RequestParam("file") MultipartFile file) { if (!file.isEmpty()) { try { byte[] bytes = file.getBytes(); // 执行存储操作... return ResponseEntity.ok("文件成功上传！"); } catch (IOException e) { return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("上传失败：" + e.getMessage()); } } return ResponseEntity.badRequest().body("请选择要上传的文件！"); } } ``` #### 方案二：添加必要依赖 如果你正在使用 Maven 构建工具，请确认 pom.xml 文件中有以下依赖之一： ```xml <!-- 使用标准 Servlet API --> <dependency> <groupId>javax.servlet</groupId> <artifactId>jstl</artifactId> <version>1.2</version> </dependency> <!-- 或者选择 Apache Commons FileUpload 库 --> <dependency> <groupId>commons-fileupload</groupId> <artifactId>commons-fileupload</artifactId> <version>1.4</version> </dependency> ``` #### 方案三：调整全局配置 在 Spring Boot 应用程序属性文件 application.properties 或 yaml 中增加以下选项以优化文件上传体验： ```properties spring.servlet.multipart.enabled=true # 启用多部件请求解析器（默认开启） spring.servlet.multipart.max-file-size=5MB # 设置每个文件的最大尺寸 spring.servlet.multipart.max-request-size=10MB # 整体请求大小上限 ``` #### 方案四：验证客户端代码是否准确 最后别忘了核查发起请求的一方（浏览器、Postman 或其他脚本）是否有按照预期构建 body 结构。特别要注意 content-type 是否一致以及各字段拼接无误。 --- ###