MappingJackson2HttpMessageConverter是Spring MVC默认注册的JSON消息转换器，依赖Jackson库实现Java对象与JSON的双向自动转换；Spring Boot引入spring-boot-starter-web即自动配置该转换器，配合@RequestBody和@ResponseBody注解即可完成JSON请求响应处理。
Spring MVC 默认就配置了 MappingJackson2HttpMessageConverter，只要项目里有 Jackson 依赖（如 jackson-databind），它就会自动处理 JSON 的请求和响应，无需手动注册。关键是要确保类路径正确、控制器方法签名合理，并理解它的默认行为和常见定制点。
确认 Jackson 依赖已引入
该转换器依赖 Jackson 库，Maven 中需包含：
-
com.fasterxml.jackson.core:jackson-databind（必需） -
com.fasterxml.jackson.core:jackson-core（databind已传递依赖，显式声明非必须） -
com.fasterxml.jackson.core:jackson-annotations（用于注解支持，如@JsonIgnore、@JsonProperty）
若使用 Spring Boot，只需引入 spring-boot-starter-web，它已默认包含这些依赖。
控制器方法如何触发 JSON 转换
转换器在以下场景自动生效：
- 请求体含 JSON 且控制器方法参数标注
@RequestBody→ 自动反序列化为 Java 对象 - 返回值类型是 POJO 或集合，且方法标注
@ResponseBody或类上有@RestController→ 自动序列化为 JSON 响应 - HTTP 请求头中
Content-Type: application/json和/或Accept: application/json会被识别并参与匹配
例如：
@PostMapping("/user")
@ResponseBody
public User createUser(@RequestBody User user) {
return userService.save(user);
}
此时请求体 JSON 会由 MappingJackson2HttpMessageConverter 解析成 User 实例。
使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。
自定义 Jackson 配置（如日期格式、空值处理）
可通过配置 ObjectMapper 来调整 JSON 行为。Spring Boot 推荐在 application.yml 中配置：
spring:
jackson:
date-format: yyyy-MM-dd HH:mm:ss
serialization-inclusion: NON_NULL
default-property-inclusion: NON_NULL
纯 Spring MVC（非 Boot）可在 Java 配置中自定义 ObjectMapper Bean，并注入到 MappingJackson2HttpMessageConverter：
@Bean
public MappingJackson2HttpMessageConverter mappingJackson2HttpMessageConverter() {
MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter();
ObjectMapper mapper = new ObjectMapper();
mapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);
mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
converter.setObjectMapper(mapper);
return converter;
}
注意：若手动注册该 Converter，需确保它被加入 RequestMappingHandlerAdapter 的 messageConverters 列表中（Spring Boot 自动完成）。
调试转换失败的常见原因
JSON 处理失败时，通常不是 Converter 本身问题，而是以下原因：
- 请求未带
Content-Type: application/json头 → Spring 不会选择该 Converter - POJO 缺少无参构造函数或字段无 getter/setter → Jackson 反序列化失败
- 字段类型不匹配（如 JSON 传字符串，Java 字段是
LocalDateTime但未配日期格式） - 循环引用未处理（如父子双向关联）→ 需加
@JsonManagedReference/@JsonBackReference或配置SerializationFeature.FAIL_ON_EMPTY_BEANS - Controller 方法没加
@ResponseBody（或没用@RestController）→ 返回值不会走消息转换流程
启用 debug 日志（org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter）可查看实际使用的 MessageConverter。
