在spring mvc中自定义消息转换器需通过webmvcconfigurer的configuremessageconverters（完全接管）或extendmessageconverters（扩展默认）注册；支持微调jackson行为或继承abstracthttpmessageconverter实现全新转换逻辑，且须配合@responsebody/@requestbody及匹配的content-type/accept头才能生效。
在 Spring MVC 中使用自定义消息转换器，核心是让框架在处理请求或响应时，能按你定义的规则完成 Java 对象与 HTTP 报文之间的转换。这通常用于支持非标准格式（如自定义文本协议）、统一响应结构、替换默认 JSON 库（如用 Gson 替 Jackson），或对序列化/反序列化过程做精细控制。
注册自定义转换器的两种主流方式
Spring MVC 提供了两种推荐的配置入口，都通过实现 WebMvcConfigurer 接口：
- configureMessageConverters：完全接管转换器列表，会清空 Spring Boot 自动配置的所有默认转换器。适合需要彻底定制的场景，但容易遗漏对 XML、表单、文件上传等的支持，需手动补全。
- extendMessageConverters：在已有转换器列表基础上插入或修改。更安全常用，比如只调整 Jackson 的 ObjectMapper 行为，其余保持默认即可。
快速定制 Jackson JSON 转换行为
大多数需求其实不需写全新转换器，而是微调 Jackson。例如关闭空 Bean 报错、忽略 null 字段、统一日期格式：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 新建配置类，实现 WebMvcConfigurer
- 重写 extendMessageConverters 方法
- 遍历 converters 列表，找到 MappingJackson2HttpMessageConverter 实例
- 获取其内部的 ObjectMapper，调用
configure(SerializationFeature.FAIL_ON_EMPTY_BEANS, false)或setSerializationInclusion(JsonInclude.Include.NON_NULL)
编写全新转换器（如处理 application/x-result）
当需要支持全新媒体类型（如 application/x-result）或完全自定义编解码逻辑时，需继承 AbstractHttpMessageConverter：
- 泛型指定你要处理的目标 Java 类型（如
ResultInfo） - 构造函数中注册支持的 MediaType 和字符集
- 重写 supports：判断当前类型是否可被本转换器处理
- 重写 readInternal：从 HttpInputMessage.getBody() 读取原始字节，解析成目标对象
- 重写 writeInternal：将目标对象序列化为字节，写入 HttpOutputMessage.getBody()
确保转换器生效的关键点
自定义转换器不是写完就自动起作用的，还需注意：
- 控制器方法必须使用 @ResponseBody（响应）或 @RequestBody（请求），否则不走消息转换流程
- 前端请求头 Content-Type 和 Accept 必须与你注册的 MediaType 匹配，比如你注册了
application/x-result，那请求就要带Accept: application/x-result - 若用
configureMessageConverters，记得调用super.configureMessageConverters(converters)再添加自定义项，否则可能丢失 String、Form 等基础转换器
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
