如何让JAXB使用自定义命名空间前缀？

针对JAXB自动生成ns2:这类默认命名空间前缀导致对接系统不兼容，且无法修改XSD的问题，以下是可行的解决办法：

一、让XJC自动生成带@XmlNs注解的package-info.java #

既然手动修改package-info.java会被Gradle的XJC任务覆盖，直接通过XJC绑定文件在代码生成阶段注入前缀配置：

• 编写一个绑定文件（例如bindings.xjb），指定命名空间与自定义前缀的映射：

<jaxb:bindings xmlns:jaxb="http://java.sun.com/xml/ns/jaxb" version="2.1">
    <jaxb:bindings schemaLocation="你的XSD文件路径">
        <jaxb:schemaBindings>
            <jaxb:package name="你的目标包名">
                <jaxb:namespacePrefixes>
                    <jaxb:namespacePrefix prefix="自定义前缀" uri="目标命名空间URI"/>
                </jaxb:namespacePrefixes>
            </jaxb:package>
        </jaxb:schemaBindings>
    </jaxb:bindings>
</jaxb:bindings>

• 在Gradle的XJC任务中引入该绑定文件，这样生成的package-info.java会自动包含@XmlNs注解，后续生成任务不会覆盖配置。

二、适配Jakarta XML Bind API 4.0.0的前缀映射方案 #

原有的Marshaller相关属性被移除后，可通过JAXB实现包提供的NamespacePrefixMapper来实现：

• 引入JAXB实现依赖（例如org.glassfish.jaxb:jaxb-runtime），实现com.sun.xml.bind.marshaller.NamespacePrefixMapper类：

public class CustomPrefixMapper extends NamespacePrefixMapper {
    @Override
    public String getPreferredPrefix(String namespaceUri, String suggestion, boolean requirePrefix) {
        if ("目标命名空间URI".equals(namespaceUri)) {
            return "自定义前缀";
        }
        // 其他命名空间使用默认建议前缀
        return suggestion;
    }
}

• 创建Marshaller时设置该映射器：

JAXBContext context = JAXBContext.newInstance(你的类.class);
Marshaller marshaller = context.createMarshaller();
marshaller.setProperty("com.sun.xml.bind.namespacePrefixMapper", new CustomPrefixMapper());

注意：该方案依赖具体JAXB实现，但在绝大多数项目中均可正常使用。

三、备选：实时XML转换（无需修改生成代码） #

如果上述方案有阻碍，可在编组完成后通过Transformer实时替换前缀，避免文件搜索替换：

// 先将对象编组为DOM文档
Document doc = ...;
// 创建Transformer处理XML
Transformer transformer = TransformerFactory.newInstance().newTransformer();
// 可通过DOM操作直接修改命名空间前缀，或使用XSLT样式表批量替换
// 最后将处理后的DOM输出为XML字符串或文件

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