### Spring Boot 中 Jackson Dataformat XML 的默认返回配置 当在 Spring Boot 项目中引入 `jackson-dataformat-xml` 并希望控制接口默认返回 JSON 而不是 XML 时，可以通过以下方式实现。 #### 控制 Content Negotiation 行为 Spring Boot 使用内容协商机制决定返回数据的格式。如果未指定 `produces` 属性，则会基于客户端请求头中的 `Accept` 字段或者全局配置来决定返回的内容类型。为了确保默认情况下返回的是 JSON 数据，可以调整如下配置： 1. **修改 application.properties 文件** 添加以下属性以优先使用 JSON 序列化工具[^2]: ```properties spring.http.converters.preferred-json-mapper=jackson ``` 2. **自定义 HttpMessageConverters** 如果需要更精细地控制消息转换器的行为，可以在应用程序启动时注册自定义的消息转换器： ```java import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.http.converter.HttpMessageConverter; import org.springframework.http.converter.json.MappingJackson2HttpMessageConverter; import org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport; import java.util.List; @Configuration public class WebConfig extends WebMvcConfigurationSupport { @Override protected void extendMessageConverters(List<HttpMessageConverter<?>> converters) { // 确保 MappingJackson2HttpMessageConverter 排序靠前 converters.add(0, new MappingJackson2HttpMessageConverter()); } } ``` 3. **设置 Accept Header 或 Produces 注解** 当调用 API 时，建议通过 HTTP 请求头显式声明期望的数据格式 (如 `application/json`)。另外，在控制器方法上也可以强制指定返回类型： ```java @RestController @RequestMapping(value = "/example", produces = {"application/json"}) public class ExampleController { @GetMapping("/data") public MyBean getData() { return new MyBean(); } } ``` 4. **移除或禁用 XML Message Converter** 若不打算支持 XML 响应，可以直接从应用上下文中排除掉对应的 converter 实现类： ```java import com.fasterxml.jackson.dataformat.xml.XmlMapper; import org.springframework.boot.autoconfigure.http.HttpMessageConverters; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.http.converter.xml.MappingJackson2XmlHttpMessageConverter; @Configuration public class CustomWebConfig { @Bean public HttpMessageConverters customConverters() { // 不包含 Xml 映射转换器 return new HttpMessageConverters(new MappingJackson2HttpMessageConverter()); } } ``` 以上措施能够有效防止因自动匹配而导致意外返回 XML 结果的情况发生[^3]。 ```java // 测试代码片段展示如何验证返回值类型 import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content; @Test public void testDefaultResponseTypeIsJson() throws Exception { mockMvc.perform(get("/api/resource")) .andExpect(content().contentType(MediaType.APPLICATION_JSON)); } ```