基于Python Spyne搭建SOAP服务 Postman请求报错未找到Envelope元素如何解决？

触发当前报错的直接问题 #

你在Postman构造的请求体中，SOAP信封的命名空间值缺少URI必需的http://协议前缀，不符合SOAP 1.1规范要求。
原请求中定义的SOAP信封命名空间为：
xmlns:soapenv="schemas.xmlsoap.org/soap/envelope/"
这个值会被XML解析器当成独立的非标准命名空间，和Spyne内置SOAP 1.1协议要求识别的、带完整http前缀的http://schemas.xmlsoap.org/soap/envelope/命名空间完全不匹配，因此解析流程从根元素开始就无法识别出合法的SOAP Envelope结构，直接抛出对应找不到Envelope的报错。

易引发后续报错的潜在问题 #

请求中绑定业务接口的命名空间值，必须和Spyne应用初始化时传入的target namespace完全一致，你当前写的xmlns:tran="spyne.examples.hello.soap"和应用配置里的字符串是匹配的，但后续对照自动生成的WSDL校验时，要确保没有遗漏字符、没有额外加路径前缀。

修正后可正常运行的请求体 #

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tran="spyne.examples.hello.soap">
    <soapenv:Header/>
    <soapenv:Body>
        <tran:say_hello>
            <tran:name>ASD</tran:name>
            <tran:times>5</tran:times>
        </tran:say_hello>
    </soapenv:Body>
</soapenv:Envelope>

额外校验注意事项 #

• 请求方法必须选择POST，Spyne的SOAP服务默认不响应GET方法的请求。
• Postman发送请求时，必须将请求头Content-Type设置为text/xml; charset=utf-8，不能保留默认的JSON类型头，否则Spyne的WSGI服务会因请求格式不匹配拒绝解析。
• 可直接访问服务地址http://127.0.0.1:8000/?wsdl查看自动生成的WSDL规范文档，文档内会明确标注SOAP信封命名空间、业务接口命名空间、参数结构的要求，按照文档结构构造请求可避免绝大多数格式类报错。

内容的提问来源于stack exchange，提问作者Edgar Navasardyan