SOAP协议是基于XML的跨平台Web服务通信规范，核心为信封式消息结构，含必需的Envelope和Body及可选Header与Fault，依赖命名空间严格校验，不支持JSON且大小写敏感。
SOAP协议是一种基于XML的标准化通信协议，专门用于Web服务之间交换结构化信息。它不依赖特定编程语言或操作系统，靠XML定义消息格式、靠HTTP等协议完成传输，核心目标是实现跨平台、强契约、高可靠的服务调用。
SOAP协议的本质定位
它不是传输协议，也不是数据格式本身，而是“用XML写、靠HTTP送、按规则解”的一套消息规范。你可以把它理解为：远程调用的“信封标准”——不管里面装的是登录请求、订单查询还是支付指令，都必须套进统一的SOAP信封里，才能被对方系统正确识别和处理。
- 不是轻量级API（像REST那样），而是企业级通信协议，强调可验证性、安全性与事务一致性
- 不绑定HTTP，但90%以上场景走HTTP POST，因为防火墙友好、穿透性强
- 必须用XML，不能用JSON；所有标签大小写敏感、必须闭合、不能含DTD或处理指令
SOAP报文的XML四要素
每条合法SOAP消息都是格式良好的XML文档，由四个逻辑部分构成，其中两个必需、两个可选：
- Envelope（信封）：根元素，唯一标识这是一条SOAP消息。必须声明命名空间，常见有http://schemas.xmlsoap.org/soap/envelope/（SOAP 1.1）或http://www.w3.org/2003/05/soap-envelope（SOAP 1.2）
- Header（头部）：可选，位于Envelope下第一子元素。常放认证令牌、会话ID、路由指令等元数据。带soap:mustUnderstand="1"属性时，接收方必须处理否则报错
- Body（主体）：必需，承载实际业务内容，比如<GetUserRequest><UserId>1001</UserId></GetUserRequest>。所有操作方法和参数都封装在这里
- Fault（错误）：可选，仅出现在Body内，用于返回结构化错误信息。包含faultcode（如Client、Server）、faultstring（人可读描述）、faultactor（出错环节）等字段
一个真实可用的SOAP请求示例
以下是一个调用用户登录接口的最小可行报文（已简化命名空间，实际使用需严格匹配WSDL）：
HR面试评价助手-Word版
下载
🎯 HR面试评价助手（Word版格式） 生成可直接复制到Word文档的标准格式HR面试评价 【使用方式】 1. 发送口令：HR面试评价 2. 粘贴JD文字 3. 上传简历文档 4. 上传面试记录（可选） 5. 复制生成的评价到Word 【输出特点】 - 纯文本格式，可直接粘贴到Word - 层次清晰，标题加粗...
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Header>
<Auth xmlns="http://api.example.com">
<Token>abc123</Token>
</Auth>
</soap:Header>
<soap:Body>
<Login xmlns="http://api.example.com">
<Username>admin</Username>
<Password>123456</Password>
</Login>
</soap:Body>
</soap:Envelope>
注意：命名空间前缀（如soap:）和URI必须与服务端WSDL完全一致；Body里的Login元素名、子节点名均由WSDL定义，不可随意更改。
怎么验证SOAP报文是否合法
不必手写解析器，日常调试可用三步快速判断：
- 用浏览器或XML校验工具打开报文，确认无语法错误（标签闭合、编码声明、命名空间拼写）
- 检查Envelope是否为根节点、是否含正确命名空间、Header是否在Body之前
- 发送到服务端后看响应——若返回Fault且faultcode为Client，大概率是报文结构或命名空间问题；若是Server，说明结构对了但业务逻辑出错
基本上就这些。SOAP不复杂但容易忽略细节，尤其命名空间和大小写，多看WSDL生成的样例最稳妥。
