postman测试webservice接口

用Postman测WebService接口，第一步不是打开Postman，而是先拿到WSDL文件。没有它，你连请求该往哪发、参数长什么样都不知道。我见过有人直接对着一个SOAP服务地址狂点Send，结果返回一堆XML解析错误，然后开始怀疑人生。问题出在：SOAP不是REST，不能靠猜。

假设你手里有一个WSDL地址，比如 http://example.com/UserService?wsdl。把它复制到Postman的地址栏，把请求方法从GET改成POST——这一步很多人会忽略，因为浏览器打开WSDL是GET，但实际调用服务必须POST。然后点Send。Postman会返回一大段XML，这就是WSDL描述文件。别急着关掉，往下翻，找到 <soap:address location="..."> 这一行，里面的URL才是真正的接口端点。很多人直接把WSDL地址当接口地址用，结果就是404或者500。

接下来要构造SOAP信封。Postman不会帮你自动生成请求体，你得手动写。一个最简的SOAP 1.1请求长这样：

<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <GetUser xmlns="http://tempuri.org/"> <userId>123</userId> </GetUser> </soap:Body> </soap:Envelope> 

注意 xmlns 后面的命名空间。WSDL里会定义 targetNamespace，必须和它一致，否则服务端可能返回“方法未找到”。我吃过这个亏：命名空间少写一个斜杠，调了半小时。

请求头也得设。在Postman的Headers标签里加两行：Content-Type: text/xml; charset=utf-8 和 SOAPAction: "http://tempuri.org/GetUser"。SOAPAction的值通常就是命名空间加方法名，但有些服务要求带引号，有些不带。最稳妥的办法是看WSDL里 <soap:operation soapAction="..."> 怎么写。如果WSDL里没写，那就留空或者随便填一个，但Content-Type必须对。我遇到过只认 application/soap+xml 的服务，那是SOAP 1.2，信封命名空间也要换成 http://www.w3.org/2003/05/soap-envelope。

点Send之后，如果返回 500 Internal Server Error，别慌。把响应体展开，SOAP的Fault信息通常在里面。比如 <faultstring>System.Web.Services.Protocols.SoapException: 服务器无法处理请求。</faultstring>，这种一般是参数类型不对。我调过一个接口，userId明明传的是数字，但服务端期望字符串，结果一直报错。后来在WSDL里看到 <s:element name="userId" type="s:string"/>，改成 <userId>123</userId> 还是不行？因为XML里数字和字符串看起来一样，但有些老框架会严格校验。加个 xsi:type="xsd:string" 才通过。

Postman有个不太显眼但好用的功能：保存请求到Collection之后，可以点Code按钮生成不同语言的调用代码。但别全信它。生成的C#或Java代码里，SOAPAction经常是空的。我一般只拿它参考请求体的结构，Headers还是自己填。

另外，如果WSDL里定义了多个 <wsdl:port>，比如同时有SOAP 1.1和SOAP 1.2的绑定，你要选对 <soap:address> 对应的那个。选错了，请求发过去也是白搭。我习惯在Postman里建两个请求，一个测1.1，一个测1.2，对比响应速度。有些老服务1.2反而更慢，不知道是不是框架的锅。

最后说个实际场景。有一次对接一个政务系统的WebService，WSDL里有个方法叫 queryEnterprise，参数是一个复杂类型 EnterpriseQuery，里面嵌套了三个子元素。我照着WSDL一层层拼XML，拼了二十分钟，发过去还是报错。后来发现WSDL里有个 <xs:choice>，意思是三个子元素只能选一个。这种细节Postman不会提示你，只能自己读WSDL。所以别嫌WSDL长，该翻的地方得翻。

测通了之后，把请求保存下来，下次直接改参数就行。Postman的环境变量也能用，比如把端点地址设成 { { soap_endpoint}}，切换测试和生产环境时不用改请求体。这比每次手动改URL省事多了。

很赞哦!（75846）