在Python中调用SOAP类型的接口时，需要按照SOAP协议的规范构造请求头和请求体，再通过requests库发送POST请求。SOAP请求的核心是正确设置Content-Type请求头，以及构造符合规范的XML格式请求体。
SOAP请求的核心参数说明
发送SOAP请求需要关注两个关键部分，分别是请求头和请求体：
- 请求头：必须设置Content-Type为text/xml; charset=utf-8，部分接口还需要添加SOAPAction字段，用于指定要调用的操作。
- 请求体：需要是符合SOAP规范的XML格式内容，包含Envelope、Header、Body等标准节点，Body中放置具体的业务参数。
完整代码示例
以下是一个调用示例SOAP接口的完整代码，包含请求构造、发送、响应解析的全流程：
import requests
# 构造SOAP请求体，注意XML内容中的特殊字符需要正确转义
soap_body = """<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://www.ipipp.com/webservice/">
<soap:Header/>
<soap:Body>
<web:GetUserInfo>
<web:userId>1001</web:userId>
</web:GetUserInfo>
</soap:Body>
</soap:Envelope>"""
# 构造请求头
headers = {
"Content-Type": "text/xml; charset=utf-8",
"SOAPAction": "http://www.ipipp.com/webservice/GetUserInfo"
}
# 目标SOAP接口地址
url = "http://192.168.0.1:8080/soap/userService"
try:
# 发送POST请求
response = requests.post(
url=url,
data=soap_body.encode("utf-8"), # 将XML字符串编码为字节流
headers=headers,
timeout=10
)
# 打印响应状态码
print(f"响应状态码：{response.status_code}")
# 打印响应内容
print(f"响应内容：{response.text}")
except Exception as e:
print(f"请求发送失败：{str(e)}")
代码关键点说明
在实际使用时需要注意以下几点：
- SOAP请求体的XML内容必须严格符合接口要求的格式，命名空间、节点名称都不能出错，否则接口会返回解析错误。
- 如果接口不需要SOAPAction字段，可以从headers中删除该配置，部分老版本SOAP服务可能要求该字段为空字符串。
- 请求体的编码需要和Content-Type中声明的charset一致，通常使用utf-8编码即可满足大部分场景需求。
- 如果接口需要身份认证，可以在headers中添加Authorization字段，或者在SOAP Header节点中添加认证相关的参数。
常见问题排查
如果请求返回错误，可以按照以下步骤排查：
- 检查SOAP请求体的XML格式是否正确，可以通过XML校验工具验证格式合法性。
- 检查Content-Type是否设置正确，错误的Content-Type会导致服务端无法解析请求体。
- 检查接口地址和SOAPAction的值是否和接口文档一致，地址错误或者操作名称错误都会导致调用失败。
- 查看响应的错误信息，大部分SOAP接口会在响应中返回具体的错误原因，根据错误提示调整请求参数即可。
PythonrequestsSOAP请求xml_header修改时间：2026-07-02 07:00:18