Spring-WS MTOM/XOP服务端使用hexBinary类型接收二进制文件时请求对象属性为空的问题咨询

你遇到的这个问题其实是Spring WS在MTOM场景下处理hexBinary类型时的常见兼容性问题，下面我来拆解原因并给出可行的解决思路：

核心原因：Spring WS MTOM实现对hexBinary的支持有限 #

虽然MTOM/XOP规范本身没有明确禁止使用hexBinary，但主流SOAP框架（包括Spring WS）的MTOM实现都是优先适配base64Binary，原因有两点：

1. XOP规范的设计初衷是配合base64Binary使用：当二进制数据被提取为MTOM附件时，SOAP消息中会用<xop:Include>标签替代原本的base64内联数据，框架可以自动识别这种替换并将附件内容映射到byte[]字段。而hexBinary并没有被纳入XOP的标准适配逻辑中，框架无法自动关联MTOM附件到hexBinary类型的字段。
2. Spring WS的默认序列化/反序列化器（比如JAXB或Spring OXM组件）对hexBinary的处理仅针对内联数据，没有适配MTOM的附件场景。当你用hexBinary定义字段时，框架会尝试解析SOAP消息中的hex编码字符串，但MTOM请求中该字段对应的是XOP引用而非实际的hex字符串，因此解析后返回null。

MTOM/XOP是否支持hexBinary？ #

严格来说，MTOM/XOP规范本身并不排斥hexBinary，但它并没有为hexBinary定义专门的附件替换机制。也就是说，理论上你可以用hexBinary配合MTOM，但几乎没有框架会原生支持这种组合，因为base64Binary已经是MTOM场景下的标准选择，更符合规范的设计预期。

可行的解决方案 #

方案1：改用base64Binary（推荐） #

如果可以修改XSD，直接将xs:hexBinary替换为xs:base64Binary，这是MTOM场景下的最佳实践。Spring WS对这种组合的支持非常完善，不需要额外配置就能正确解析MTOM附件并填充byte[]字段，这也是你之前测试成功的原因。

方案2：自定义适配器适配hexBinary + MTOM #

如果必须保留hexBinary类型，你需要自定义JAXB适配器来处理hex字符串和字节数组的转换，同时让Spring WS的MTOM逻辑识别这个适配器。具体步骤如下：

1. 实现一个XmlAdapter来处理hexBinary和byte[]的互转：

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

public class HexBinaryAdapter extends XmlAdapter<String, byte[]> {
    @Override
    public byte[] unmarshal(String hexString) throws Exception {
        return hexString == null ? null : DatatypeConverter.parseHexBinary(hexString);
    }

    @Override
    public String marshal(byte[] bytes) throws Exception {
        return bytes == null ? null : DatatypeConverter.printHexBinary(bytes);
    }
}

2. 在生成的请求对象的对应字段上添加注解，指定自定义适配器并关联MTOM的内容类型：

import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlMimeType;
import javax.xml.bind.annotation.adapters.XmlJavaTypeAdapter;

public class YourRequestObject {
    @XmlElement(name = "thebinaryfile")
    @XmlJavaTypeAdapter(HexBinaryAdapter.class)
    @XmlMimeType("application/octet-stream")
    private byte[] thebinaryfile;

    // getter和setter方法
    public byte[] getThebinaryfile() {
        return thebinaryfile;
    }

    public void setThebinaryfile(byte[] thebinaryfile) {
        this.thebinaryfile = thebinaryfile;
    }
}

3. 确保Spring WS的配置中启用了MTOM，比如在@Configuration类中配置MtomMessageFactory：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.ws.soap.saaj.SaajMtomMessageFactory;

@Configuration
public class WebServiceConfig {
    @Bean
    public SaajMtomMessageFactory messageFactory() {
        SaajMtomMessageFactory messageFactory = new SaajMtomMessageFactory();
        messageFactory.setMtomEnabled(true);
        return messageFactory;
    }
}

方案3：检查请求的hex格式一致性 #

如果上述方案还是有问题，需要确认SoapUI发送的请求中，thebinaryfile元素的hex字符串是否符合规范（比如没有多余空格、大小写统一）。虽然你说请求是一致的，但hex编码的微小差异也可能导致解析失败。

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