### 解决 Spring 中 `HttpMessageNotWritableException` 异常 当处理 `multipart/form-data` 类型请求时，如果返回的对象无法被任何可用的消息转换器（`HttpMessageConverter`）序列化，则会抛出 `HttpMessageNotWritableException`。此问题通常发生在控制器方法尝试返回复杂对象（如自定义类 `ResultHolder`），而未配置适当的消息转换器来支持该类型的序列化。 以下是解决方案的关键点： #### 配置消息转换器 为了使 Spring 能够正确处理复杂的响应数据结构，需确保已注册适合的 `HttpMessageConverter` 实现。例如，在 XML 数据场景下可以使用 `Jaxb2RootElementHttpMessageConverter` 来解析和生成基于 JAXB 的对象[^1]。对于 JSON 或其他媒体类型，可能需要额外引入对应的转换器实现。 ```java @Configuration public class WebConfig implements WebMvcConfigurer { @Override public void configureMessageConverters(List<HttpMessageConverter<?>> converters) { // 添加JSON转换器或其他必要的转换器 MappingJackson2HttpMessageConverter jsonConverter = new MappingJackson2HttpMessageConverter(); jsonConverter.setSupportedMediaTypes(Collections.singletonList(MediaType.APPLICATION_JSON)); converters.add(jsonConverter); converters.add(new FormHttpMessageConverter()); // 支持表单数据 // 如果涉及到XML, 可以添加如下转换器 Jaxb2RootElementHttpMessageConverter xmlConverter = new Jaxb2RootElementHttpMessageConverter(); converters.add(xmlConverter); } } ``` #### 处理 multipart 请求中的文件上传字段 在接收 `multipart/form-data` 请求参数时，应特别注意区分普通字段与文件字段。通过注入 `MultipartFile` 参数可轻松捕获上传文件的内容。然而，若希望将整个请求体映射到单一实体类上，则需要创建专门用于描述此类输入格式的数据传输对象 (DTO)，并为其提供合适的 getter 和 setter 方法以便于绑定各个部分。 ```java @RestController @RequestMapping("/upload") public class FileUploadController { @PostMapping(consumes = MediaType.MULTIPART_FORM_DATA_VALUE) public ResponseEntity<ResultHolder> handleFileUpload( @RequestPart("file") MultipartFile file, @RequestPart("metadata") Metadata metadata) throws IOException { byte[] bytes = file.getBytes(); // 获取文件字节数组 String fileName = StringUtils.cleanPath(file.getOriginalFilename()); // 构造业务逻辑后的结果封装至ResultHolder实例中... ResultHolder result = processUploadedData(bytes, fileName, metadata); return ResponseEntity.ok(result); // 返回成功状态码及结果对象 } private ResultHolder processUploadedData(byte[] content, String name, Metadata meta){ // ...具体实现省略... } } // DTO 定义样例 class Metadata{ private String key; private int value; // Getters & Setters ... } ``` #### 设置正确的 Content-Type 响应头 有时即使服务器端能够正常生成目标资源表示形式，客户端仍可能会因为预期不符而导致错误提示。因此建议显式指定 HTTP 响应头部信息中的 `Content-Type` 字段值，从而帮助消费者理解实际接收到的是何种媒介类型的数据流。 ```java return ResponseEntity.status(HttpStatus.OK) .contentType(MediaType.APPLICATION_JSON_UTF8) .body(result); ``` 以上调整有助于缓解由于缺乏兼容性转换机制所引发的一系列异常状况。 --- ###