base64是xml内嵌图片唯一可靠的纯文本方案,将二进制转为ascii字符串以兼容xml文本要求;mtom则是soap专属的传输优化机制,通过mime multipart分离二进制数据与xml正文,二者适用场景与协议栈严格区分。

XML里直接放图片,Base64 是唯一靠谱的纯文本方案
XML 本身只认文本,二进制数据(比如 image/jpeg)不能原样塞进去。Base64 编码把字节流转成 ASCII 字符串,XML 就能安全容纳。这是最通用、兼容性最强的做法,尤其适合小图或配置类场景。
- 用
base64.b64encode()(Python)或btoa()(JS 浏览器端)生成编码字符串,注意去掉换行(replace('\n', '')) - XML 中用普通元素包裹,例如:
<photo>/9j/4AAQSkZJRgABAQAAA...</photo>
- 服务端解析时需调用
base64.b64decode()或atob()还原,再校验 MIME 类型和长度,防止注入恶意内容 - 缺点明显:体积膨胀约 33%,无流式处理能力,大文件(>1MB)易触发内存溢出或超时
MTOM 不是 XML 格式,而是 SOAP 消息的传输优化机制
MTOM(Message Transmission Optimization Mechanism)常被误认为“XML 内嵌二进制”,其实它根本没改 XML 结构——它只是把 Base64 编码块从 XML 正文中抽出来,换成 xop:Include 引用,并用 MIME multipart 包装整个 SOAP 请求。XML 本身仍是纯文本,只是多了个指向外部二进制部分的指针。
第一步】:将安装包中所有的文件夹和文件用ftp工具以二进制方式上传至服务器空间;(如果您不知如何设置ftp工具的二进制方式,可以查看:(http://www.shopex.cn/support/qa/setup.help.717.html)【第二步】:在浏览器中输入 http://您的商店域名/install 进行安装界面进行安装即可。【第二步】:登录后台,工具箱里恢复数据管理后台是url/sho
- 启用 MTOM 需客户端和服务端同时支持,例如 Java 的
javax.xml.ws.BindingProvider设MTOM_ENABLED=true - Wireshark 抓包会看到类似这样的 HTTP body:
Content-Type: multipart/related; boundary="uuid:abc"; type="application/xop+xml" --uuid:abc Content-Type: application/xop+xml; charset=UTF-8; type="text/xml" <?xml version="1.0"?> <env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/"> <env:Body> <upload> <data><xop:Include href="cid:img1" xmlns:xop="http://www.w3.org/2004/08/xop/include"/></data> </upload> </env:Body> </env:Envelope> --uuid:abc Content-ID: @@##@@ Content-Transfer-Encoding: binary Content-Type: image/png ‰PNG...[raw bytes]... - 关键点:XML 里的
<include></include>必须带命名空间声明,且href值要和Content-ID严格匹配(包括尖括号) - 调试失败时先检查 SOAP Action 头、MIME boundary 是否一致,再确认服务端是否真正启用了 MTOM 解析(不是只开了开关但没配处理器)
别混用 Base64 和 MTOM,它们解决的是不同层级的问题
Base64 是数据编码方式,MTOM 是消息打包协议。你可以在 MTOM 消息里不用 Base64(直接传原始二进制),也可以在非 MTOM 的 XML 里用 Base64——两者正交。强行在普通 XML 里写 <include></include> 标签只会被当作文本内容解析失败。
- 如果用 REST API(非 SOAP),就老实用 Base64,别碰 MTOM——HTTP/1.1 没标准定义 multipart SOAP,主流框架(如 Spring Boot WebMvc)根本不处理
xop:Include - 如果用老派 SOAP Web Service(如 Apache CXF、.NET WCF),优先开 MTOM;但要注意客户端 SDK 生成的 stub 可能默认禁用,得手动设置
enableMTOM或等效参数 - 文件大于 5MB 且必须走 XML 流程时,MTOM 几乎是唯一选择;否则 Base64 更简单、更可控
实际选型看三点:协议栈、工具链、文件大小
没有银弹。Base64 简单粗暴但吃资源,MTOM 高效但绑定 SOAP 生态。很多团队踩坑是因为没看清自己用的到底是不是真正的 SOAP 栈。
- 查清你调用的 endpoint 是不是
wsdl地址,返回的Content-Type是不是multipart/related,而不是text/xml - 用
curl -v或 Postman 发一个最小请求,看 raw response header 和 body 结构,比读文档快十倍 - 如果后端是 Node.js(如
soap库)或 Python(zeep),确认版本是否支持 MTOM 解析——旧版zeep会静默忽略xop:Include









