JAXB反序列化报错javax.xml.bind.UnmarshalException求助排查

核心报错原因 #

org.xml.sax.SAXParseException: Content is not allowed in prolog 说明JAXB尝试解析的内容不是合法的XML格式，或者XML开头存在无效字符（比如BOM、空格、非XML声明的字符）。结合你的代码和类注解，主要存在以下问题：

1. 输入内容格式不匹配 #

Sample类同时使用了@JsonProperty（Jackson JSON注解）和JAXB注解，但JAXB的Unmarshaller仅能解析XML，若POST请求传入的是JSON字符串，直接用JAXB解析必然报错。

2. 冗余的字符串编码处理 #

代码中new String(str.getBytes())属于无效操作，会破坏原字符串的编码格式，可能引入不可见的无效字符，导致XML解析器判定prolog（XML声明前的部分）存在非法内容。

3. JAXB注解不完整 #

Sample类仅标注了@XmlRootElement和@XmlAccessorType，未给字段添加@XmlElement指定XML元素名，即使输入是XML，也可能因字段名不匹配导致解析失败。

针对性解决方案 #

方案一：若输入为JSON（推荐，因类中使用了@JsonProperty） #

放弃JAXB，改用Jackson解析JSON字符串：

// 替换原JAXB解析代码段
ObjectMapper objectMapper = new ObjectMapper();
Sample sample = objectMapper.readValue(str, Sample.class);

方案二：若输入为XML #

1. 修复字符串处理代码，移除冗余的编码转换：

// 原错误代码
// StringReader reader = new StringReader(new String(str.getBytes()));
// 改为直接使用原字符串
StringReader reader = new StringReader(str);

2. 补充Sample类的JAXB注解，确保XML元素名匹配：

@XmlRootElement(name = "Sample")
@XmlAccessorType(XmlAccessType.FIELD)
@JsonInclude(Include.NON_NULL)
public class Sample{
    @JsonProperty("name")
    @XmlElement(name = "name") // 对应XML中的<name>元素
    private String name= null;

    @JsonProperty("Number")
    @XmlElement(name = "Number") // 对应XML中的<Number>元素
    private String Number= null; 
}

3. 确保输入XML格式合法，示例如下：

<Sample>
    <name>testName</name>
    <Number>123</Number>
</Sample>

方案三：清理XML开头的无效字符 #

若确认输入是XML但存在UTF-8 BOM或空白字符，可先清理字符串：

// 移除开头的UTF-8 BOM及空白字符
str = str.trim().replaceFirst("^\\uFEFF", "");
StringReader reader = new StringReader(str);

内容的提问来源于stack exchange，提问作者Amit Nijhawan