Java 1.8中JAXB处理SOAP请求遇解组异常求助

问题场景 #

我在Windows 10系统上运行Java 1.8.0_191程序时遇到了JAXB解组异常，程序使用jaxb2 Maven插件2.5.0版本生成的类处理传入的XML SOAP请求，具体异常信息如下：

JAXB解组异常；嵌套异常为javax.xml.bind.UnmarshalException，关联异常为[org.xml.sax.SAXParseException; lineNumber: 1; columnNumber: 622; cvc-complex-type.2.4.a : 从元素'MotifCommande'开始发现无效内容。预期值为'{AliasCde,RefExterneCde, DateDepot}'之一。]

对应的英文错误提示：

从MotifCommande项开始发现无效内容。预期为'{AliasCde, RefExterneCde, DateDepot}'之一。

这里有两个核心疑问需要解答：

1. 预期项列表包含两个可选字段（AliasCde和RefExterneCde）和一个必填字段（DateDepot），为何不只显示必填字段？
2. XSD中MotifCommande标签出现在必填的DateDepot标签之后，为何异常信息却指出从MotifCommande标签开始内容无效？

疑问1：为什么异常会列出所有预期元素（包括可选）？ #

XML Schema验证器在触发cvc-complex-type.2.4.a错误时，会如实列出当前位置所有合法的可出现元素，不会区分字段是必填还是可选。

这是因为验证器的逻辑是：“在当前解析位置，我遇到了一个不符合规则的元素，这里允许出现的元素是以下这些”——它只关注当前位置的合法元素集合，而不会过滤掉可选元素。举个例子，如果你的XSD定义的序列是AliasCde?（可选）→ RefExterneCde?（可选）→ DateDepot（必填），那么在DateDepot之前的位置，允许出现的元素就是这三个（可选元素可以出现也可以不出现，但如果出现必须按顺序）。当验证器在这个位置遇到MotifCommande时，就会把所有合法选项都列出来。

疑问2：为什么异常指向MotifCommande而非DateDepot的位置？ #

这和XML Schema的序列验证顺序以及错误报告机制有关。假设你的XSD中元素顺序定义为：

<xs:sequence>
  <xs:element name="AliasCde" type="xs:string" minOccurs="0"/>
  <xs:element name="RefExterneCde" type="xs:string" minOccurs="0"/>
  <xs:element name="DateDepot" type="xs:date" minOccurs="1"/>
  <xs:element name="MotifCommande" type="xs:string" minOccurs="0"/>
</xs:sequence>

当SOAP请求中跳过了必填的DateDepot，直接出现MotifCommande时，验证器会按顺序检查：

1. 检查是否有AliasCde（可选，无也合法）
2. 检查是否有RefExterneCde（可选，无也合法）
3. 接下来应该出现必填的DateDepot，但实际遇到的是MotifCommande——此时验证器会判定当前元素不符合预期，但它会把第一个遇到的不符合规则的元素位置作为错误点，也就是MotifCommande的位置，而非直接报告“缺失DateDepot”。

简单来说，验证器是按顺序解析元素，遇到第一个不符合序列规则的元素就抛出错误，不会先扫描整个文档查找缺失的必填元素。

解决建议 #

1. 检查你的SOAP请求XML，确认是否在MotifCommande之前正确包含了必填的DateDepot元素，并且元素顺序严格遵循XSD定义的序列。
2. 如果XSD中定义的顺序是DateDepot在前、MotifCommande在后，那么请求XML必须严格遵守这个顺序，不能跳过必填元素直接放置后续元素。

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