@PostMapping(value = "/compare",consumes = "multipart/form-data") public R compare(@RequestParam("File") MultipartFile file, @RequestParam("jsonContent") String jsonContent) { //读取PDF文本 String pdfText = compareService.extractContent(file); //解析JSON配置 JsonNode jsonConfig = null; try { jsonConfig = compareService.parseJson(jsonContent); } catch (Exception e) { return R.fail(MessageUtils.message("failed.convert.json")); } //执行对比校验 List<ValidationResult> results = compareService.compareContent(pdfText, jsonConfig); //返回没有匹配成功的数据 List<ValidationResult> failedResults = new ArrayList<>(); for (ValidationResult result : results) { if (!result.isValid()) { failedResults.add(result); } } if (failedResults.isEmpty()) { return R.ok("条件符合规范"); } else { return R.ok(failedResults); } }这个就是我的代码啊

<think>我们正在解决Spring Boot中如何接收multipart/form-data请求，该请求包含一个文件和一个JSON字符串参数的问题。 根据引用[2]和[3]的内容，我们知道multipart/form-data适合传输二进制数据（如文件）和文本数据混合的情况，而application/json虽然适合结构化数据，但不适合直接传输文件（需要转为Base64，效率低）。 解决方案： 1. 使用`@RequestPart`注解分别接收文件和JSON字符串。 2. 将JSON字符串手动解析为对象（使用ObjectMapper）。 示例代码： 步骤1：在控制器方法中，使用`@RequestPart`注解两个部分： - 文件部分：类型为`MultipartFile` - JSON字符串部分：类型为`String`，然后使用`ObjectMapper`解析为对象 步骤2：配置`consumes`属性为`MediaType.MULTIPART_FORM_DATA_VALUE` 详细代码示例： ```java import com.fasterxml.jackson.databind.ObjectMapper; import org.springframework.http.MediaType; import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.RequestPart; import org.springframework.web.bind.annotation.RestController; import org.springframework.web.multipart.MultipartFile; @RestController public class FileUploadController { private final ObjectMapper objectMapper = new ObjectMapper(); @PostMapping(value = "/upload", consumes = MediaType.MULTIPART_FORM_DATA_VALUE) public String handleFileUpload( @RequestPart("file") MultipartFile file, @RequestPart("jsonData") String jsonData) throws Exception { // 解析JSON字符串为自定义对象 MyDataObject myDataObject = objectMapper.readValue(jsonData, MyDataObject.class); // 处理文件 // 例如：保存文件 // file.transferTo(new File("/path/to/file")); // 处理业务逻辑... return "Upload successful! File size: " + file.getSize() + ", JSON data: " + myDataObject.toString(); } // 定义内部类作为JSON解析的对象 public static class MyDataObject { private String key1; private int key2; // 必须有无参构造函数 public MyDataObject() { } // getter和setter public String getKey1() { return key1; } public void setKey1(String key1) { this.key1 = key1; } public int getKey2() { return key2; } public void setKey2(int key2) { this.key2 = key2; } @Override public String toString() { return "MyDataObject{" + "key1='" + key1 + '\'' + ", key2=" + key2 + '}'; } } } ``` 前端请求示例（使用Postman或类似工具）： - 设置请求方法：POST - 设置请求URL：http://localhost:8080/upload - 设置Content-Type：multipart/form-data - 添加两个部分： 1. 文件部分：key为"file"，选择文件 2. 文本部分：key为"jsonData"，值为JSON字符串，例如：{"key1":"value1", "key2":123} 注意：如果前端发送的JSON字符串是作为文本部分，那么Content-Type可以设置为text/plain（或者不设置，浏览器会自动设置），后端接收为字符串后解析。 引用[4]中提到，如果使用了自定义的过滤器（Filter）对请求进行包装，需要注意multipart/form-data请求的参数获取方式与普通表单不同。如果遇到获取参数的问题，可能需要调整过滤器。 另外，根据引用[2]，Spring Boot从6.0开始只支持StandardServletMultipartResolver，所以我们需要确保在配置中启用了文件上传支持（默认是启用的）。 配置文件上传限制（在application.properties中）： ```properties # 设置单个文件最大大小 spring.servlet.multipart.max-file-size=10MB # 设置整个请求最大大小 spring.servlet.multipart.max-request-size=20MB ``` 如果遇到中文乱码问题，可以添加字符编码过滤器（UTF-8）。 总结：使用`@RequestPart`分别接收文件和JSON字符串，然后手动解析JSON字符串，这是处理multipart/form-data请求中混合文件和其他复杂类型（如JSON）的常用方法。 相关问题： 1. 如何在前端使用FormData对象发送文件和JSON数据？ 2. Spring Boot如何处理多个文件上传？ 3. 如何验证上传文件的类型？ 4. 如何实现大文件分片上传？ 5. 如何解决multipart/form-data请求中的中文乱码问题？</think>### Spring Boot 接收 `multipart/form-data` 请求的完整实现 #### 核心解决方案（基于引用[2][3]的最佳实践） ```java import org.springframework.web.bind.annotation.*; import org.springframework.web.multipart.MultipartFile; import com.fasterxml.jackson.databind.ObjectMapper; import com.fasterxml.jackson.databind.JsonNode; @RestController public class FileUploadController { // 使用 @RequestPart 分别接收文件和JSON参数 @PostMapping(value = "/upload", consumes = MediaType.MULTIPART_FORM_DATA_VALUE) public ResponseEntity<String> handleUpload( @RequestPart("file") MultipartFile file, // 文件参数 @RequestPart("jsonData") String jsonDataString) // JSON字符串参数 { try { // 1. 解析JSON参数 ObjectMapper objectMapper = new ObjectMapper(); JsonNode jsonData = objectMapper.readTree(jsonDataString); // 2. 处理文件 String fileName = file.getOriginalFilename(); byte[] fileContent = file.getBytes(); // 3. 业务逻辑处理（示例） String result = "文件: " + fileName + " | 大小: " + file.getSize() + " bytes\n" + "JSON参数: " + jsonData.toPrettyString(); return ResponseEntity.ok(result); } catch (Exception e) { return ResponseEntity.status(500).body("处理失败: " + e.getMessage()); } } } ``` #### 关键配置说明 1. **`@RequestPart` 注解** - `file`: 对应前端FormData中的文件字段名 - `jsonData`: 对应前端FormData中的JSON文本字段名 - 使用 `consumes` 明确指定媒体类型 2. **JSON参数处理技巧** ```java // 将JSON字符串转换为对象 MyDataObject dataObj = objectMapper.readValue(jsonDataString, MyDataObject.class); // 直接获取JSON节点值 String value = jsonData.get("key").asText(); ``` 3. **配置文件上传限制（application.properties）** ```properties # 单个文件最大10MB spring.servlet.multipart.max-file-size=10MB # 请求整体最大20MB spring.servlet.multipart.max-request-size=20MB # 启用文件临时存储 spring.servlet.multipart.enabled=true ``` #### 前端请求示例（JavaScript） ```javascript const formData = new FormData(); // 添加文件 formData.append('file', document.getElementById('fileInput').files[0]); // 添加JSON参数（必须是字符串） const jsonData = { key1: 'value1', key2: 'value2' }; formData.append('jsonData', JSON.stringify(jsonData)); // 发送请求 fetch('/upload', { method: 'POST', body: formData // 注意：不要手动设置Content-Type，浏览器会自动生成boundary }); ``` #### 常见问题解决方案 1. **文件为空** - 检查前端字段名是否与 `@RequestPart("file")` 一致 - 确保文件大小未超过配置限制 2. **JSON解析失败** - 验证前端是否使用 `JSON.stringify()` - 添加日志输出原始字符串：`System.out.println("Received JSON: " + jsonDataString);` 3. **中文乱码** 在配置类中添加编码过滤器： ```java @Bean public FilterRegistrationBean<CharacterEncodingFilter> encodingFilter() { FilterRegistrationBean<CharacterEncodingFilter> bean = new FilterRegistrationBean<>(); bean.setFilter(new CharacterEncodingFilter()); bean.addInitParameter("encoding", "UTF-8"); bean.addInitParameter("forceEncoding", "true"); bean.addUrlPatterns("/*"); return bean; } ``` 4. **大文件上传优化** - 分片上传（前端切割文件） - 启用临时文件存储： ```properties spring.servlet.multipart.file-size-threshold=2MB spring.servlet.multipart.location=/tmp/uploads ``` #### 方案对比（基于引用[1][3]） | 方案 | 适用场景 | 传输效率 | 实现复杂度 | |------|----------|----------|------------| | `multipart/form-data` | 文件+JSON混合 | ★★★★★ | ★★☆ | | Base64嵌入JSON | 小文件 | ★★☆ | ★☆☆ | | 单独文件接口 | 纯文件上传 | ★★★★ | ★☆☆ | > **最佳实践**：对于包含文件和结构化数据的请求，`multipart/form-data` 在传输效率和服务器兼容性上具有显著优势[^2][^3]。通过 `@RequestPart` 注解可清晰分离文件与JSON参数，避免Base64编码的开销和解码复杂性。 --- ### 相关问题 1. 如何在前端实现大文件分片上传？ 2. Spring Boot 如何验证上传文件的类型和安全性？ 3. 如何实现文件上传进度条显示？ 4. 使用 `multipart/form-data` 时如何接收数组参数？ 5. 生产环境中文件存储的最佳实践是什么？ [^1]: JSON 格式数据传输的优缺点分析 [^2]: multipart/form-data 请求解析机制 [^3]: 混合数据上传方案对比 [^4]: 请求包装器在文件上传中的应用