如何使用Zeep库配置所需命名空间格式适配WSDL服务要求

解决方案 #

共有两种可落地的实现方案，可根据实际场景选择：

方案1：自定义命名空间前缀映射 #

Zeep原生支持在初始化客户端时指定prefix_mappings参数，提前将命名空间和目标前缀绑定，即可避免每个数组子项单独生成重复的命名空间前缀，代码示例如下：

from zeep import Client
from zeep.transports import Transport

# 按照服务要求定义命名空间和前缀的映射关系
namespace_mapping = {
    # 此处替换为WSDL中`s`前缀对应的实际服务命名空间地址
    "s": "http://your-service-root-namespace",
    # 对应微软标准数组命名空间，绑定到要求的前缀`a`
    "a": "http://schemas.microsoft.com/2003/10/Serialization/Arrays"
}

transport = Transport()
client = Client(
    service_url, 
    transport=transport,
    strict=False,
    # 传入自定义前缀映射
    prefix_mappings=namespace_mapping
)

# 后续数组构造逻辑保持不变即可
images = client.get_type("ns4:ArrayOfstring")()
local_images = [
    "https://www.example.com/variant_image.png",
    "https://www.example.com/variant_image2.png",
    "https://www.example.com/variant_image3.png",
]

for image in local_images:
    images["string"].append(image)

该方案无需修改序列化逻辑，即可满足90%以上的命名空间格式要求。

方案2：使用Zeep插件修改序列化后的XML #

如果方案1仍无法完全匹配服务的特殊格式要求，可以通过Zeep的插件机制，在请求发出前直接修改生成的XML内容，代码示例如下：

from zeep import Client, Plugin
from zeep.transports import Transport
from lxml import etree

class NamespaceAdaptPlugin(Plugin):
    def egress(self, envelope, http_headers, operation, binding_options):
        # 定位Images节点，替换为你实际的服务命名空间
        images_node = envelope.find(".//{http://your-service-root-namespace}Images")
        if images_node is not None:
            # 给Images节点添加a命名空间声明
            images_node.set("xmlns:a", "http://schemas.microsoft.com/2003/10/Serialization/Arrays")
            # 批量修改子节点的命名空间前缀
            for string_node in images_node.iterchildren():
                if string_node.tag.endswith("string"):
                    string_node.tag = "{http://schemas.microsoft.com/2003/10/Serialization/Arrays}string"
        return envelope, http_headers

# 初始化客户端时传入插件
transport = Transport()
client = Client(
    service_url, 
    transport=transport,
    strict=False,
    plugins=[NamespaceAdaptPlugin()]
)

注意事项 #

• 代码中http://your-service-root-namespace需要替换为实际WSDL定义中s前缀对应的命名空间地址，可直接从WSDL的定义部分查询获取。
• 优先使用方案1，仅当服务存在非标准XML格式要求时再使用方案2做兜底修改。

内容的提问来源于stack exchange，提问作者Sencer H.