基于Zeep的Python SOAP客户端：过滤序列化字典非必要键适配更新请求

我之前也碰到过一模一样的情况——用Zeep的serialize_object拿到Get请求的响应后，直接传给Update接口总是因为多余字段报错。折腾了一阵后，终于找到靠谱的解决办法，核心思路是先明确Update方法要求的字段，再递归过滤掉响应里不需要的键：

第一步：获取Update请求的必填/允许字段列表 #

首先可以通过Zeep客户端直接提取Update操作对应的类型定义，这样能精准拿到所有需要保留的字段：

from zeep import Client

# 初始化Zeep客户端
client = Client('你的WSDL地址')

# 获取Update请求对应的类型，比如假设类型名为'UpdateRequestType'，命名空间是ns0
update_type = client.get_type('ns0:UpdateRequestType')

# 提取该类型下的所有字段名
allowed_fields = list(update_type.elements.keys())

如果不确定命名空间或者类型名，直接打印update_type.elements就能看到完整的字段结构和命名空间信息。

第二步：编写递归过滤函数 #

SOAP响应往往有嵌套结构（比如子对象、数组列表），所以必须用递归处理所有层级的内容：

def filter_zeep_response(data, allowed_fields):
    # 处理列表类型：递归过滤每个元素
    if isinstance(data, list):
        return [filter_zeep_response(item, allowed_fields) for item in data]
    # 处理字典类型：只保留允许的键，同时递归处理值
    elif isinstance(data, dict):
        filtered_dict = {}
        for key, value in data.items():
            if key in allowed_fields:
                # 如果值是嵌套对象/列表，继续递归过滤
                filtered_dict[key] = filter_zeep_response(value, allowed_fields)
        return filtered_dict
    # 基础类型（字符串、数字等）直接返回
    else:
        return data

如果你的响应里有明确的嵌套子对象（比如User对象包含Address子对象），可以提前为每个子类型单独获取字段列表，优化过滤逻辑：

# 提前获取子类型字段
address_fields = list(client.get_type('ns0:AddressType').elements.keys())
# 维护嵌套类型的字段映射
nested_field_map = {
    'User': allowed_fields,
    'Address': address_fields
}

def filter_zeep_response(data, allowed_fields):
    if isinstance(data, list):
        return [filter_zeep_response(item, allowed_fields) for item in data]
    elif isinstance(data, dict):
        filtered_dict = {}
        # 如果Zeep序列化后带_type字段，可以用它判断当前对象类型
        current_obj_type = data.get('_type')
        current_allowed = nested_field_map.get(current_obj_type, allowed_fields)
        
        for key, value in data.items():
            if key in current_allowed:
                # 递归处理嵌套对象时，传入对应的字段列表
                nested_allowed = nested_field_map.get(key, [])
                filtered_dict[key] = filter_zeep_response(value, nested_allowed)
        return filtered_dict
    else:
        return data

第三步：应用过滤并调用Update接口 #

现在就可以用这个函数处理序列化后的响应，再传给Update方法：

from zeep.helpers import serialize_object

# 调用Get接口并序列化响应
get_result = client.service.GetTargetObject(id=123)
serialized_data = serialize_object(get_result)

# 过滤出Update需要的字段
filtered_data = filter_zeep_response(serialized_data, allowed_fields)

# 发起Update请求
client.service.UpdateTargetObject(**filtered_data)

额外注意事项 #

• 可选字段无需特殊处理：过滤函数会自动保留响应中存在的允许字段，忽略不存在的。
• 字段名要严格匹配：注意WSDL的命名风格（驼峰/下划线），确保allowed_fields里的键和序列化字典的键完全一致。
• 复杂WSDL调试：可以用zeep.xsd.dump(update_type)打印完整的类型结构，帮助你准确提取字段。

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