Spring Boot3中如何为Jaxb2Marshaller设置命名空间别名？

在Spring Boot 3环境下，旧版JAXB的com.sun.xml.bind.namespacePrefixMapper属性已不再适用，直接设置jakarta.xml.bind.namespacePrefixMapper会触发"属性不支持"的报错。这是因为Jakarta JAXB规范并未定义统一的命名空间前缀映射属性，不同的JAXB实现（如EclipseLink MOXy、GlassFish JAXB RI）有各自的实现方式，以下是三种可行方案：

方案一：基于EclipseLink MOXy实现（Spring Boot 3默认适配） #

1. 确保引入MOXy依赖（Spring Boot 3 starter通常已包含，若缺失可手动添加）：

<dependency>
    <groupId>org.eclipse.persistence</groupId>
    <artifactId>org.eclipse.persistence.moxy</artifactId>
</dependency>

2. 实现MOXy专属的NamespacePrefixMapper并配置到Jaxb2Marshaller：

@Bean
Jaxb2Marshaller marshaller() {
    Jaxb2Marshaller marshaller = new Jaxb2Marshaller();
    marshaller.setContextPath("providers.nos.ws.client");

    // 自定义命名空间前缀映射
    org.eclipse.persistence.oxm.NamespacePrefixMapper prefixMapper = new org.eclipse.persistence.oxm.NamespacePrefixMapper() {
        @Override
        public String getPreferredPrefix(String namespaceUri, String suggestion, boolean requirePrefix) {
            // 针对目标命名空间返回指定前缀，其他命名空间使用默认建议值
            if ("http://your-target-namespace-uri".equals(namespaceUri)) {
                return "ns1";
            }
            return suggestion;
        }
    };

    Map<String, Object> jaxbProps = new HashMap<>();
    // 使用MOXy专属的属性名
    jaxbProps.put("eclipselink.namespace-prefix-mapper", prefixMapper);
    marshaller.setJaxbContextProperties(jaxbProps);

    return marshaller;
}

方案二：基于GlassFish JAXB RI实现 #

1. 引入GlassFish JAXB RI依赖：

<dependency>
    <groupId>org.glassfish.jaxb</groupId>
    <artifactId>jaxb-runtime</artifactId>
</dependency>

2. 实现GlassFish JAXB RI的NamespacePrefixMapper并配置：

@Bean
Jaxb2Marshaller marshaller() {
    Jaxb2Marshaller marshaller = new Jaxb2Marshaller();
    marshaller.setContextPath("providers.nos.ws.client");

    com.sun.xml.bind.marshaller.NamespacePrefixMapper prefixMapper = new com.sun.xml.bind.marshaller.NamespacePrefixMapper() {
        @Override
        public String getPreferredPrefix(String namespaceUri, String suggestion, boolean requirePrefix) {
            if ("http://your-target-namespace-uri".equals(namespaceUri)) {
                return "ns1";
            }
            return suggestion;
        }
    };

    Map<String, Object> jaxbProps = new HashMap<>();
    jaxbProps.put("com.sun.xml.bind.namespacePrefixMapper", prefixMapper);
    marshaller.setJaxbContextProperties(jaxbProps);

    return marshaller;
}

方案三：使用JAXB绑定文件（无代码实现） #

若不想编写Java代码，可通过XML绑定文件配置前缀：

1. 在resources目录下创建bindings.xml：

<jaxb:bindings xmlns:jaxb="https://jakarta.ee/xml/ns/jaxb"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               jaxb:version="3.0">
    <jaxb:bindings schemaLocation="your-wsdl-or-schema-path.xsd">
        <jaxb:schemaBindings>
            <jaxb:package name="providers.nos.ws.client"/>
            <!-- 为目标命名空间指定前缀 -->
            <jaxb:namespacePrefix name="http://your-target-namespace-uri" prefix="ns1"/>
        </jaxb:schemaBindings>
    </jaxb:bindings>
</jaxb:bindings>

2. 配置Marshaller加载绑定文件：

@Bean
Jaxb2Marshaller marshaller() {
    Jaxb2Marshaller marshaller = new Jaxb2Marshaller();
    marshaller.setContextPath("providers.nos.ws.client");
    // 指定绑定文件路径
    marshaller.setBindings(new Resource[]{new ClassPathResource("bindings.xml")});
    return marshaller;
}

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