Spring MVC 中 @RestController 返回 XML 需添加 jackson-dataformat-xml 依赖,用 @JacksonXmlRootElement 和 @JacksonXmlProperty 标注实体类,并在控制器方法中指定 produces = MediaType.APPLICATION_XML_VALUE。

Spring MVC 中使用 @RestController 返回 XML 数据,核心在于让 Spring 能正确序列化对象为 XML,并设置响应的 Content-Type 为 application/xml。默认情况下,@RestController 依赖 Jackson(处理 JSON),要支持 XML 需额外配置和依赖。
添加 Jackson XML 序列化支持依赖
在 Maven 的 pom.xml 中引入 jackson-dataformat-xml:
com.fasterxml.jackson.dataformat jackson-dataformat-xml
该依赖会自动注册 XmlMapper,Spring Boot 2.2+ 会自动识别并启用 XML 消息转换器(Jackson2ObjectMapperBuilder + MappingJackson2XmlHttpMessageConverter)。
确保实体类支持 XML 序列化
用 Jackson 的注解标注 POJO,例如:
import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlRootElement;
import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlProperty;
@JacksonXmlRootElement(localName = "user")
public class User {
@JacksonXmlProperty(localName = "id")
private Long id;
@JacksonXmlProperty(localName = "name")
private String name;
// getter/setter 省略
}
-
@JacksonXmlRootElement:指定根元素名 -
@JacksonXmlProperty:控制字段对应 XML 元素名及是否作为属性(加isAttribute = true) - 字段需有 public getter,或开启
setVisibility配置才能访问私有字段
控制器方法声明 Accept 和 Produces
显式指定支持 XML 响应,推荐写法:
@GetMapping(value = "/user/{id}", produces = MediaType.APPLICATION_XML_VALUE)
public User getUser(@PathVariable Long id) {
return new User(id, "Alice");
}
-
produces = MediaType.APPLICATION_XML_VALUE告诉 Spring 此接口只返回 XML - 客户端请求头带
Accept: application/xml时才会匹配(若同时支持 JSON 和 XML,可写produces = {MediaType.APPLICATION_XML_VALUE, MediaType.APPLICATION_JSON_VALUE}) - 不写
produces时,Spring 会根据请求头Accept自动协商,但需确保客户端明确指定
验证与调试小技巧
如果返回仍是 JSON 或报 406 Not Acceptable 错误,检查以下几点:










