Java使用JAXB生成XML时自定义命名空间前缀未生效问题

• 自定义的NamespaceMapper未注册到JAXB Marshaller中，JAXB默认会自动生成ns2/ns3/ns4这类随机前缀，不会使用你定义的rsm/ram/qdt等前缀。
• NamespaceMapper内的前缀匹配逻辑写反：方法入参是命名空间URI，代码里却拿前缀常量和URI做相等判断，永远无法命中自定义前缀规则。
• 包级配置package-info.java存在无效的测试命名空间http://www.example.com/FOO，且所有RAM命名空间下的嵌套实体字段（比如BusinessProcessSpecifiedDocumentContextParameter、ID）未显式指定对应命名空间，导致JAXB将RAM命名空间设为根节点的默认无命名空间，子节点全部丢失ram前缀。
• package-info.java如果未放在所有JAXB实体类所在的包路径下，配置完全不生效。

1. 修正NamespaceMapper逻辑 #

注意根据引入的JAXB版本选择正确的父类导包：Java 8内置JAXB使用com.sun.xml.internal.bind.marshaller.NamespacePrefixMapper，JDK9+独立引入的JAXB RI使用com.sun.xml.bind.marshaller.NamespacePrefixMapper。

public class NamespaceMapper extends NamespacePrefixMapper {
    public static final String QDT_PREFIX = "qdt";
    public static final String QDT_URI = "urn:un:unece:uncefact:data:standard:QualifiedDataType:100";

    public static final String RAM_PREFIX = "ram";
    public static final String RAM_URI = "urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100";

    public static final String RSM_PREFIX = "rsm";
    public static final String RSM_URI = "urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100";

    public static final String UDT_PREFIX = "udt";
    public static final String UDT_URI = "urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100";

    public static final String XSI_PREFIX = "xsi";
    public static final String XSI_URI = "http://www.w3.org/2001/XMLSchema-instance";

    @Override
    public String getPreferredPrefix(String namespaceUri, String suggestion, boolean requirePrefix) {
        // 修正：匹配URI而非前缀
        if(QDT_URI.equals(namespaceUri)) return QDT_PREFIX;
        if(RAM_URI.equals(namespaceUri)) return RAM_PREFIX;
        if(RSM_URI.equals(namespaceUri)) return RSM_PREFIX;
        if(UDT_URI.equals(namespaceUri)) return UDT_PREFIX;
        if(XSI_URI.equals(namespaceUri)) return XSI_PREFIX;
        return suggestion;
    }

    @Override
    public String[] getPreDeclaredNamespaceUris() {
        return new String[] { QDT_URI, RAM_URI, RSM_URI, UDT_URI, XSI_URI };
    }
}

2. 修正package-info.java配置 #

删除无效的测试命名空间，确保文件放在所有JAXB实体类所在的包下：

@XmlSchema(
        elementFormDefault= XmlNsForm.QUALIFIED,
        namespace = NamespaceMapper.RSM_URI,
        xmlns={
                @XmlNs(prefix="qdt", namespaceURI=NamespaceMapper.QDT_URI),
                @XmlNs(prefix="ram", namespaceURI=NamespaceMapper.RAM_URI),
                @XmlNs(prefix="rsm", namespaceURI=NamespaceMapper.RSM_URI),
                @XmlNs(prefix="udt", namespaceURI=NamespaceMapper.UDT_URI),
                @XmlNs(prefix="xsi", namespaceURI=NamespaceMapper.XSI_URI)
        }
)
package fr.dsidiff.app.ui.model.request.metadata;

import javax.xml.bind.annotation.XmlNs;
import javax.xml.bind.annotation.XmlNsForm;
import javax.xml.bind.annotation.XmlSchema;

注意：如果实体类分散在不同包下，每个包都要添加对应包级配置，否则未配置包下的实体会出现命名空间异常。

3. 为所有嵌套实体字段添加正确的命名空间注解 #

所有属于ram/qdt/udt命名空间的字段，必须在@XmlElement注解上显式指定namespace，不要依赖包级默认命名空间，示例：

// ExchangedDocumentContext类
@Data
@XmlAccessorType(XmlAccessType.FIELD)
public class ExchangedDocumentContext {
    @XmlElement(name = "BusinessProcessSpecifiedDocumentContextParameter", namespace = NamespaceMapper.RAM_URI)
    private DocumentContextParameter businessProcessSpecifiedDocumentContextParameter;

    @XmlElement(name = "GuidelineSpecifiedDocumentContextParameter", namespace = NamespaceMapper.RAM_URI)
    private DocumentContextParameter guidelineSpecifiedDocumentContextParameter;
}

// 嵌套的DocumentContextParameter类
@Data
@XmlAccessorType(XmlAccessType.FIELD)
public class DocumentContextParameter {
    @XmlElement(name = "ID", namespace = NamespaceMapper.RAM_URI)
    private String id;
}

其他实体类（比如ExchangedDocument、SupplyChainTradeTransaction及其下属字段）按照相同规则，根据字段所属命名空间添加对应namespace属性即可。

4. 修改序列化方法，注册命名空间映射器 #

根据使用的JAXB版本选择对应的属性名，将自定义Mapper注册到Marshaller：

private String payloadToXml(CrossIndustryInvoice invoice) throws JAXBException {
    try {
        JAXBContext ctx = JAXBContext.newInstance(CrossIndustryInvoice.class);
        Marshaller jaxbMarshaller = ctx.createMarshaller();
        jaxbMarshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, Boolean.TRUE);
        jaxbMarshaller.setProperty(Marshaller.JAXB_ENCODING, "UTF-8");

        // Java8内置JAXB使用这行配置
        jaxbMarshaller.setProperty("com.sun.xml.internal.bind.namespacePrefixMapper", new NamespaceMapper());
        // 高版本独立JAXB RI使用这行配置，二选一
        // jaxbMarshaller.setProperty("com.sun.xml.bind.namespacePrefixMapper", new NamespaceMapper());

        StringWriter sw = new StringWriter();
        jaxbMarshaller.marshal(invoice, sw);
        return sw.toString();
    } catch (JAXBException e) {
        e.printStackTrace();
        throw new JAXBException("XML序列化失败");
    }
}

依赖参考（JDK9+需引入） #

如果使用JDK9及以上版本，内置JAXB已被移除，需在pom.xml中引入独立依赖避免包冲突：

<dependencies>
    <dependency>
        <groupId>jakarta.xml.bind</groupId>
        <artifactId>jakarta.xml.bind-api</artifactId>
        <version>2.3.3</version>
    </dependency>
    <dependency>
        <groupId>com.sun.xml.bind</groupId>
        <artifactId>jaxb-impl</artifactId>
        <version>2.3.3</version>
    </dependency>
</dependencies>

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