Jaxb2Marshaller配置问题：xsd:boolean序列化为1/0无效

我之前也碰到过这个棘手的问题！JAXB的适配器配置有时候确实容易踩坑，咱们一步步来排查和解决：

1. 先确保你的XmlAdapter实现正确 #

首先得确认适配器的逻辑没问题，这是基础。正确的JaxbBooleanAdapter应该是这样的：

import javax.xml.bind.annotation.adapters.XmlAdapter;

public class JaxbBooleanAdapter extends XmlAdapter<String, Boolean> {
    @Override
    public Boolean unmarshal(String value) throws Exception {
        if (value == null) {
            return null;
        }
        // 兼容1/0和默认的true/false，避免反序列化报错
        return "1".equals(value) || "true".equalsIgnoreCase(value);
    }

    @Override
    public String marshal(Boolean value) throws Exception {
        if (value == null) {
            return null;
        }
        return value ? "1" : "0";
    }
}

2. 全局配置Jaxb2Marshaller的正确姿势 #

如果是通过Spring配置Jaxb2Marshaller，一定要确保适配器被正确添加到Marshaller实例中，很多人就是这里漏了关键步骤：

@Bean
public Jaxb2Marshaller soapMarshaller() {
    Jaxb2Marshaller marshaller = new Jaxb2Marshaller();
    // 设置生成的Java模型类的包路径
    marshaller.setContextPath("com.your.project.generated.soap");
    // 核心操作：添加你的布尔适配器
    marshaller.setAdapters(new JaxbBooleanAdapter());
    return marshaller;
}

如果是非Spring环境手动创建Marshaller，要通过setProperty指定适配器：

JAXBContext context = JAXBContext.newInstance("com.your.project.generated.soap");
Marshaller marshaller = context.createMarshaller();
marshaller.setProperty(Marshaller.JAXB_ADAPTERS, new JaxbBooleanAdapter());

⚠️ 注意：一定要确保你在序列化/反序列化时用的是这个配置好的Marshaller实例，别不小心创建了新的未配置的实例！

3. 给XJC生成的类自动添加适配器注解（推荐） #

直接手动修改XJC生成的Java类很不友好，下次生成代码又会被覆盖。最好用XJC的绑定文件（binding.xjb），让生成类时自动给所有xsd:boolean字段加上@XmlJavaTypeAdapter注解：

创建binding.xjb文件：

<jaxb:bindings xmlns:jaxb="http://java.sun.com/xml/ns/jaxb"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               jaxb:version="2.1">
    <!-- 绑定到你的WSDL或XSD文件，替换成实际路径 -->
    <jaxb:bindings schemaLocation="src/main/resources/your-service.wsdl">
        <jaxb:globalBindings>
            <!-- 把xsd:boolean类型映射到java.lang.Boolean，并指定适配器 -->
            <jaxb:javaType name="java.lang.Boolean"
                           xmlType="xsd:boolean"
                           adapter="com.your.project.adapter.JaxbBooleanAdapter"/>
        </jaxb:globalBindings>
    </jaxb:bindings>
</jaxb:bindings>

然后在Maven的XJC插件中指定这个绑定文件（如果用Maven构建）：

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>jaxb2-maven-plugin</artifactId>
    <version>2.5.0</version>
    <executions>
        <execution>
            <goals>
                <goal>xjc</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <schemaFiles>your-service.wsdl</schemaFiles>
        <!-- 指定绑定文件 -->
        <bindingFiles>src/main/resources/binding.xjb</bindingFiles>
        <packageName>com.your.project.generated.soap</packageName>
    </configuration>
</plugin>

重新执行mvn clean generate-sources，生成的类里所有xsd:boolean对应的字段都会自动带上@XmlJavaTypeAdapter(JaxbBooleanAdapter.class)注解，不用手动修改！

4. 排查常见的生效障碍 #

• 检查适配器的包路径是否正确，有没有被项目的类加载器正确加载
• 确认全局配置的Marshaller是你实际使用的那个，避免代码中存在多个Marshaller实例导致配置不生效
• 验证XML中的目标字段确实是xsd:boolean类型，不是自定义的布尔类型
• 测试时可以开启JAXB的调试日志，看看序列化时是否调用了你的适配器方法

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