本文详解如何通过 jackson 的 `@jacksonxmltext` 注解，准确解析同时包含属性（如 `os="ios"`）和文本值（如 `13`）的 xml 元素，解决因忽略文本内容导致 pojo 字段为空的问题。
在使用 Jackson 的 XmlMapper 进行 XML 反序列化时，若目标 XML 节点既携带属性（attribute），又内嵌文本内容（text content），默认情况下 Jackson 不会自动将文本映射到 Java 字段——这正是问题的核心：<Iphone os="ios">13</Iphone> 中的 "13" 无法被 Iphone.iphone 字段捕获，除非显式声明其为“文本内容”。
✅ 正确做法：使用 @JacksonXmlText
@JacksonXmlText 是 Jackson XML 模块专用注解，用于标识某个字段应接收该 XML 元素的字符内容（即 element body text），与 @JacksonXmlProperty（处理属性）或 @JacksonXmlElementWrapper（处理集合包装）等协同工作。
以下是修正后的完整 POJO 定义：
import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlProperty;
import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlText;
import lombok.Data;
@Data
public class PhoneDetails {
@JacksonXmlProperty(localName = "Iphone")
private Iphone iphoneDetails;
}
@Data
public class Iphone {
@JacksonXmlProperty(localName = "os") // 映射属性 os="ios"
private String os;
@JacksonXmlText // ✅ 关键：映射 <Iphone>...</Iphone> 中的纯文本 "13"
private String iphone;
}? 示例反序列化代码（精简可靠）
import com.fasterxml.jackson.dataformat.xml.XmlMapper;
import java.io.IOException;
public class Demo {
public static void main(String[] args) throws IOException {
XmlMapper xmlMapper = new XmlMapper();
// 推荐关闭未知属性报错（可选，提升健壮性）
xmlMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
String xml = "<PhoneDetails><Iphone os=\"ios\">13</Iphone></PhoneDetails>";
PhoneDetails result = xmlMapper.readValue(xml, PhoneDetails.class);
System.out.println(result);
// 输出：PhoneDetails(iphoneDetails=Iphone(os=ios, iphone=13))
}
}⚠️ 注意事项与常见误区
- ❌ 不要省略 @JacksonXmlText：仅靠 @JacksonXmlProperty 或无注解无法捕获文本内容；
- ✅ 属性与文本可共存：一个 XML 元素可同时拥有多个属性（用 @JacksonXmlProperty 分别标注）和唯一一段文本（由 @JacksonXmlText 标注）；
- ? 文本字段类型需为 String（或其他支持的标量类型，如 Integer、Boolean；Jackson 会自动转换）；
- ? 确保已引入 Jackson XML 依赖（Maven）：
<dependency> <groupId>com.fasterxml.jackson.dataformat</groupId> <artifactId>jackson-dataformat-xml</artifactId> <version>2.17.0</version> <!-- 建议使用 2.15+ 版本 --> </dependency>
✅ 总结
当 XML 元素形如 <Tag attr="value">text</Tag> 时，必须通过 @JacksonXmlText 显式标注接收 text 的字段，才能完成完整反序列化。这是 Jackson XML 处理混合内容（attributes + text）的标准且唯一推荐方式。正确使用该注解后，结构清晰、类型安全、无需手动解析字符串，大幅提升 XML 数据集成效率与可靠性。
