MTOM是一种绕过Base64编码传输二进制数据的机制，将大块二进制数据作为MIME附件剥离出XML正文，用xop:Include引用，避免33%体积膨胀；仅当单次传输超1–2KB时才节省带宽，需服务端客户端双向启用且底层支持MIME。
MTOM 是什么：不是“编码”，而是“绕过编码”的传输策略
MTOM（Message Transmission Optimization Mechanism）不是一种新的数据编码方式，而是让 SOAP 消息“跳过 Base64 编码”来传二进制数据的机制。它本质是把大块二进制数据（比如图片、PDF、视频片段）从 XML 正文中剥离出来，作为原始字节放在 MIME 多部分消息的独立附件里，再用 xop:Include 元素在 SOAP 主体中“打个引用”。这样就避免了 Base64 带来的 33% 体积膨胀和编解码 CPU 开销。
关键点在于：MTOM 不改变 XML 结构本身，只改变传输打包方式；它依赖底层协议支持 MIME（如 HTTP），且必须和服务端/客户端双向启用才生效。
什么时候启用 MTOM 才真有用？看 payload 大小阈值
MTOM 只在二进制数据较大时体现价值——实测表明，当单次传输的 Stream 或 byte[] 超过约 1–2 KB 时，MTOM 才开始节省带宽和时间。小于这个量级反而可能因 MIME 封包开销略增消息体积。
-
text encoding with a 100 byte payload: 433→mtom encoding with a 100 byte payload: 912（MTOM 更大） -
text encoding with a 1000000 byte payload: 1333633→mtom encoding with a 1000000 byte payload: 1001080（节省超 33 万字节）
所以别一上来就全局开启 MTOM；先确认你的接口确实常传 >5 KB 的文件流，再针对性配置。
.NET 中启用 MTOM：WSHttpBinding 配置 + 合约约束缺一不可
在 WCF（.NET Framework）中，仅改 messageEncoding="mtom" 不够，还必须满足两个条件：服务契约参数类型为 Stream（或 byte[]），且绑定必须显式启用 MTOM。
<wsHttpBinding> <binding name="MtomBinding" messageEncoding="mtom" /> </wsHttpBinding>
对应的服务接口要写成：
[ServiceContract]
public interface IUpload
{
[OperationContract]
int Upload(Stream data); // 必须是 Stream，不能是 byte[]（WCF 会自动优化）
}
常见坑：
- 用
byte[]参数时，WCF 默认仍走文本编码，除非手动设置transferMode="Streamed"并配好maxReceivedMessageSize - 客户端未同步配置 MTOM 绑定，会导致“无法识别 Content-Type: application/xop+xml”错误
- IIS 托管时，需确保 ASP.NET 注册正确：
%windir%\Microsoft.NET\Framework\v4.0.xxxxx\aspnet_regiis.exe -i
Java/JAX-WS 中启用 MTOM：注解 + 客户端显式开关
JAX-WS 默认禁用 MTOM，需在服务端接口加 @BindingType(value = SOAPBinding.SOAP11HTTP_MTOM_BINDING)，并在客户端通过 BindingProvider 开启：
Binding binding = service.getSomePort().getBinding(); SOAPBinding soapBinding = (SOAPBinding) binding; soapBinding.setMTOMEnabled(true);
注意：
- WSDL 必须声明
xs:base64Binary类型字段，否则 JAX-WS 不会触发 MTOM 流程 - Apache CXF 用户可用
org.apache.cxf.binding.soap.saaj.SAAJOutInterceptor配合mtom-enabled=true属性 - Spring Boot + WebServiceTemplate 场景下，需自定义
WebServiceMessageSender并注入HttpComponentsMessageSender启用 MTOM 支持
真正容易被忽略的是：MTOM 消息的 Content-Type 必须是 application/xop+xml，任何中间代理（如 Nginx、API 网关）若强制重写 header 或限制 multipart 类型，都会导致解析失败——这点比代码配置更常出问题。
