如何在上传的XML中嵌入二进制数据(如图片) Base64与MTOM

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 中用普通元素包裹，例如：

  /9j/4AAQSkZJRgABAQAAA...

• 服务端解析时需调用 base64.b64decode() 或 atob() 还原，再校验 MIME 类型和长度，防止注入恶意内容
• 缺点明显：体积膨胀约 33%，无流式处理能力，大文件（>1MB）易触发内存溢出或超时

MTOM 不是 XML 格式，而是 SOAP 消息的传输优化机制

MTOM（Message Transmission Optimization Mechanism）常被误认为“XML 内嵌二进制”，其实它根本没改 XML 结构——它只是把 Base64 编码块从 XML 正文中抽出来，换成 xop:Include 引用，并用 MIME multipart 包装整个 SOAP 请求。XML 本身仍是纯文本，只是多了个指向外部二进制部分的指针。

• 启用 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"
  
  
  
    
      
        
      
    
  
  
  --uuid:abc
  Content-ID: @@##@@
  Content-Transfer-Encoding: binary
  Content-Type: image/png
  
  ‰PNG...[raw bytes]...

• 关键点：XML 里的 必须带命名空间声明，且 href 值要和 Content-ID 严格匹配（包括尖括号）
• 调试失败时先检查 SOAP Action 头、MIME boundary 是否一致，再确认服务端是否真正启用了 MTOM 解析（不是只开了开关但没配处理器）

别混用 Base64 和 MTOM，它们解决的是不同层级的问题

Base64 是数据编码方式，MTOM 是消息打包协议。你可以在 MTOM 消息里不用 Base64（直接传原始二进制），也可以在非 MTOM 的 XML 里用 Base64——两者正交。强行在普通 XML 里写 标签只会被当作文本内容解析失败。

通吃客零食网整站 for Shopex

第一步】：将安装包中所有的文件夹和文件用ftp工具以二进制方式上传至服务器空间;(如果您不知如何设置ftp工具的二进制方式，可以查看：(http://www.shopex.cn/support/qa/setup.help.717.html)【第二步】：在浏览器中输入 http://您的商店域名/install 进行安装界面进行安装即可。【第二步】：登录后台，工具箱里恢复数据管理后台是url/sho

下载

• 如果用 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