### 解决方案 当遇到 `HttpMediaTypeNotSupportedException` 异常，提示内容类型 `multipart/form-data` 不被支持时，通常是因为未正确配置文件上传解析器（`MultipartResolver`）。以下是解决问题的方法： #### 配置 Multipart Resolver 为了处理多部分请求（`multipart/form-data`），需要在 Spring 应用程序中注册并启用一个合适的 `MultipartResolver` 实现类。常见的实现有 `StandardServletMultipartResolver` 和基于 Commons FileUpload 的 `CommonsMultipartResolver`。 ##### 使用 StandardServletMultipartResolver 这是推荐的方式之一，适用于 Servlet 3.0 或更高版本的容器环境。通过 Java 配置方式可以如下设置： ```java import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.web.multipart.MultipartResolver; import org.springframework.web.multipart.support.StandardServletMultipartResolver; @Configuration public class WebConfig { @Bean public MultipartResolver multipartResolver() { return new StandardServletMultipartResolver(); } } ``` 如果使用 XML 配置，则可以通过以下方式进行定义： ```xml <bean id="multipartResolver" class="org.springframework.web.multipart.support.StandardServletMultipartResolver"/> ``` 此方法依赖于 servlet 容器本身来解析多部分数据[^1]。 ##### 启用 DispatcherServlet 处理 multipart 请求 确保在 web.xml 中启用了对 multipart 请求的支持或者在 Spring Boot 中设置了相应的属性。对于 Spring Boot 用户来说，在 application.properties 文件中添加以下配置即可： ```properties spring.servlet.multipart.enabled=true spring.servlet.multipart.max-file-size=10MB spring.servlet.multipart.max-request-size=10MB ``` 这些参数分别控制是否允许文件上传以及单个文件和整个请求的最大大小限制。 #### 创建表单页面 创建用于文件上传的 HTML 表单时，请务必指定正确的编码类型 (`enctype`) 及提交地址。下面是一个简单的 JSP 页面实例： ```html <h1>Please upload a file</h1> <form method="post" action="<portlet:actionURL/>" enctype="multipart/form-data"> <input type="file" name="file"/> <input type="submit"/> </form> ``` 上述代码片段展示了如何构建一个多部分表单以便用户能够选择并上传文件到服务器端。 #### 控制器逻辑编写 最后一步是在控制器层接收客户端发送过来的数据包，并绑定至模型对象上。这里给出一段基本示例作为参考： ```java package spittr.web; import org.springframework.stereotype.Controller; import org.springframework.ui.ModelMap; import org.springframework.util.FileCopyUtils; import org.springframework.web.bind.annotation.*; import org.springframework.web.multipart.MultipartFile; import java.io.File; import java.io.IOException; @Controller @RequestMapping("/upload") public class UploadController { private static final String UPLOAD_DIR = "/uploads/"; @PostMapping("") public String handleFileUpload(@RequestParam("name") String name, @RequestParam("file") MultipartFile file, ModelMap model) throws IOException { if (!file.isEmpty()) { byte[] bytes = file.getBytes(); // Save the uploaded file locally or process it as needed. try { File serverFile = new File(UPLOAD_DIR + file.getOriginalFilename()); FileCopyUtils.copy(bytes, serverFile); model.addAttribute("message", "You successfully uploaded '" + file.getOriginalFilename() + "'"); } catch (Exception e) { model.addAttribute("message", "Failed to upload '" + file.getOriginalFilename() + "' => " + e.getMessage()); } return "result"; } else { model.addAttribute("message", "The selected file was empty."); return "error"; } } } ``` 该段代码展示了一个完整的文件上传流程，包括获取前端传递来的文件流、保存本地副本等功能模块[^2]。 --- ### 注意事项 - 如果仍然抛出异常，请确认项目中的所有组件均已更新至最新稳定版。 - 对于大型应用程序而言，考虑引入异步机制优化用户体验；同时也要注意安全性方面的问题比如防止恶意脚本注入攻击等风险因素。