JAXB反序列化无法解析带有xmlns属性的@XmlElement问题

我有两个XML文件：
第一个文件内容：

<parent>
    <child>TEXT</child>
</parent> 

第二个文件结构相同，但<child>元素带有xmlns属性：

<parent>
   <child xmlns="...">TEXT</child>
</parent> 

对应的JAXB绑定类代码（Kotlin）：

@XmlRootElement(name = "child")
class Child {

    @XmlValue
    val value: String? = null
}

@XmlRootElement(name = "parent")
class Parent {

    @XmlElement
    val child: Child? = null
}

使用第一个XML文件时，能正常读取<child>中的TEXT内容；但用第二个XML文件时，读取结果为null，无法获取TEXT。

无法读取TEXT的完整测试代码：

import jakarta.xml.bind.JAXBContext
import jakarta.xml.bind.annotation.*
import java.io.ByteArrayInputStream
import java.io.InputStream

@XmlRootElement(name = "child")
class Child {

    @XmlValue
    val value: String? = null
}

@XmlRootElement(name = "parent")
class Parent {

    @XmlElement
    val child: Child? = null

}

fun main() {
    val targetStream: InputStream = ByteArrayInputStream(
        """
            <parent>
                <child xmlns="...">TEXT</child>
            </parent> 
        """.toByteArray()
    )
    val context = JAXBContext.newInstance(Parent::class.java)
    val parent = context.createUnmarshaller().unmarshal(targetStream) as Parent
    println(parent.child?.value)
}

问题核心在于XML命名空间的匹配逻辑：

• 第一个XML里的<child>没有声明命名空间，属于无命名空间元素。
• 第二个XML里的<child>通过xmlns="..."绑定了指定命名空间，此时该元素属于这个命名空间下，不再是无命名空间元素。

而你的JAXB绑定类中：

• Child类的@XmlRootElement(name = "child")未指定namespace属性，默认绑定无命名空间的<child>。
• Parent类的@XmlElement也未指定命名空间，JAXB会自动寻找无命名空间的<child>，自然匹配不上带命名空间的目标元素，最终导致child属性为null，其value也就无法读取。

根据XML中实际的命名空间值，修改绑定类的注解配置即可：

方式1：单独给元素指定命名空间 #

假设XML里的xmlns值为http://example.com/ns，修改代码如下：

// 给Child类绑定对应命名空间
@XmlRootElement(name = "child", namespace = "http://example.com/ns")
class Child {
    @XmlValue
    val value: String? = null
}

@XmlRootElement(name = "parent")
class Parent {
    // 给child属性指定对应命名空间
    @XmlElement(namespace = "http://example.com/ns")
    val child: Child? = null
}

方式2：包级别统一配置命名空间 #

如果多个元素属于同一个命名空间，可以在包下创建package-info.kt文件统一配置：

@XmlSchema(
    namespace = "http://example.com/ns",
    elementFormDefault = XmlNsForm.QUALIFIED // 声明包内所有元素默认使用该命名空间
)
package your.actual.package.name // 替换为你的类所在包名

import jakarta.xml.bind.annotation.XmlNsForm
import jakarta.xml.bind.annotation.XmlSchema

之后绑定类无需单独指定命名空间，即可自动匹配带命名空间的XML元素：

@XmlRootElement(name = "child")
class Child {
    @XmlValue
    val value: String? = null
}

@XmlRootElement(name = "parent")
class Parent {
    @XmlElement
    val child: Child? = null
}

内容的提问来源于stack exchange，提问作者Uroš Jarc