Python调用SOAP接口请求失败无法获取响应 寻求解决方案

问题场景：Python发起SOAP服务调用时，请求无法正常发出，无法获取接口响应，当前编写的代码如下：

排查步骤 #

1 先确认链路本身通畅 #

不要一开始就死磕代码，先用SoapUI、Postman导入服务对应的WSDL文件，手动发起一次请求：

• 确认服务地址可正常访问，不存在IP白名单拦截、防火墙封禁、网络不通的问题
• 确认接口要求的鉴权信息（账号密码、Token、签名、请求头等）、入参格式完全正确，工具可以正常拿到响应
• 如果工具都调不通，直接找服务提供方确认服务状态、接入权限、参数规则，不用浪费时间排查代码

2 检查依赖库与基础请求配置 #

Python调用SOAP优先用成熟的zeep库，不要自己手动拼接XML发请求，很容易踩命名空间、节点层级的坑。如果坚持手写requests请求，必须满足以下要求：

• 请求头必须携带Content-Type: text/xml; charset=utf-8，绝大多数SOAP服务还要求必填SOAPAction头，值必须和WSDL里定义的目标接口action完全一致，漏写、写错都会被服务端直接拒绝
• 请求体XML严格匹配WSDL定义的命名空间、参数层级、参数名，大小写完全敏感，节点顺序不对、命名空间写错、参数名拼错都会导致请求失败
• 不要漏写超时配置，避免请求一直挂起无返回

3 参考标准代码模板对照修正 #

zeep库标准调用模板（推荐）

from zeep import Client
from zeep.transports import Transport
import requests
import traceback

# 自定义会话，处理鉴权、证书、超时等配置
session = requests.Session()
# 按需开启对应配置
# session.auth = ("你的接口账号", "你的接口密码")  # 基础鉴权
# session.verify = False  # 忽略自签名SSL证书校验
transport = Transport(session=session, timeout=15)

# 替换为可正常访问的WSDL地址
client = Client(wsdl="替换为你的WSDL地址", transport=transport)
# 打印服务所有可用方法、入参规则，先确认调用的方法名、参数顺序/名称正确
print(client.service)

try:
    # 替换为你要调用的方法名，按打印出的入参要求传参
    resp = client.service.你的接口方法名(参数1="值1", 参数2="值2")
    print("接口响应：", resp)
except Exception as e:
    # 打印完整异常栈，不要只捕获不输出
    traceback.print_exc()

requests手写SOAP请求模板

import requests
import traceback

url = "替换为你的SOAP服务请求地址"
headers = {
    "Content-Type": "text/xml; charset=utf-8",
    "SOAPAction": "替换为服务要求的SOAPAction值"  # 部分服务可留空，以WSDL要求为准
}
# 直接复用你在SoapUI里调通的完整XML请求体，不要手动随意拼接
xml_body = """
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:srv="http://服务对应的命名空间地址/">
   <soapenv:Header/>
   <soapenv:Body>
      <srv:你的接口方法名>
         <srv:参数1>值1</srv:参数1>
         <srv:参数2>值2</srv:参数2>
      </srv:你的接口方法名>
   </soapenv:Body>
</soapenv:Envelope>
"""

try:
    resp = requests.post(
        url=url,
        data=xml_body.encode("utf-8"),
        headers=headers,
        timeout=15
    )
    # 先打印状态码和原始返回内容，不要直接做解析，先看服务端返回的错误信息
    print("响应状态码：", resp.status_code)
    print("原始响应内容：", resp.text)
except Exception as e:
    traceback.print_exc()

4 常见错误对应处理 #

• 连接超时/连接拒绝：检查网络、代理配置、服务地址是否正确，是否被防火墙/IP白名单拦截
• 401/403状态码：鉴权信息错误，没有接口访问权限
• 415状态码：Content-Type请求头配置错误
• 500状态码：请求体格式错误、参数不符合要求，查看响应内容里的faultstring字段，会明确标注具体错误原因（比如缺参数、参数类型不对、命名空间错误等）

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