使用Zeep调用Python AXL/SOAP接口：如何避免字典键重复？

我编写了如下请求：

client.updateLdapAuthentication(**{'authenticateEndUsers': authenticateEndUsers, 'distinguishedName': distinguishedName, 'ldapPassword': ldapPassword, 'userSearchBase': userSearchBase, 'servers':{'server': {'hostName': '172.20.23.230', 'ldapPortNumber': '3268', 'sslEnabled': 'false'}}})

该请求生成了预期的SOAP请求报文：

<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"> <soap-env:Body> <ns0:updateLdapAuthentication xmlns:ns0="...

请问在此类基于Zeep的Python AXL/SOAP请求中，如何避免出现字典键重复的问题？

解决方法 #

在Zeep处理AXL/SOAP请求时，字典键重复通常要么是手动构造请求结构时的失误，要么是对WSDL定义的元素结构理解有误。以下是几个实用的解决思路：

1. 严格匹配WSDL定义的结构

Zeep是基于WSDL生成客户端的，所以首先要确认你构造的字典结构和WSDL中updateLdapAuthentication操作的参数定义完全一致。比如，如果servers元素允许包含多个server子元素，你需要把server包装成列表而不是单个字典——直接重复server键在Python字典里会被自动覆盖（Python 3.7+字典会保留最后一个重复键的值），这会导致SOAP请求丢失数据。

正确的多服务器写法示例：

servers={'server': [
    {'hostName': '172.20.23.230', 'ldapPortNumber': '3268', 'sslEnabled': 'false'},
    {'hostName': '172.20.23.231', 'ldapPortNumber': '3268', 'sslEnabled': 'false'}
]}

2. 使用Zeep自动生成的请求类型

与其手动构造容易出错的字典，不如利用Zeep从WSDL生成的强类型对象来构建请求。这样Zeep会自动校验每个字段的合法性，从根源上避免键重复或结构错误。

示例代码：

from zeep import Client

# 初始化Zeep客户端
client = Client('path/to/your/axl.wsdl')

# 获取对应的请求类型
UpdateLdapReq = client.get_type('ns0:UpdateLdapAuthenticationReq')

# 构造类型安全的请求对象
ldap_request = UpdateLdapReq(
    authenticateEndUsers=authenticateEndUsers,
    distinguishedName=distinguishedName,
    ldapPassword=ldapPassword,
    userSearchBase=userSearchBase,
    servers={
        'server': [
            {'hostName': '172.20.23.230', 'ldapPortNumber': '3268', 'sslEnabled': 'false'}
        ]
    }
)

# 发送请求
client.service.updateLdapAuthentication(ldap_request)

3. 手动校验字典的键唯一性

如果坚持手动构造字典，要注意Python字典本身不允许重复键（后定义的会覆盖先定义的）。可以在传入Zeep之前，添加一个简单的校验步骤，比如检查字典的键是否唯一：

def check_duplicate_keys(d):
    seen = set()
    for key in d:
        if key in seen:
            raise ValueError(f"Duplicate key found: {key}")
        seen.add(key)
        # 递归检查嵌套字典
        if isinstance(d[key], dict):
            check_duplicate_keys(d[key])

# 构造请求字典后先校验
request_dict = {
    'authenticateEndUsers': authenticateEndUsers,
    'distinguishedName': distinguishedName,
    'ldapPassword': ldapPassword,
    'userSearchBase': userSearchBase,
    'servers':{'server': {'hostName': '172.20.23.230', 'ldapPortNumber': '3268', 'sslEnabled': 'false'}}
}

check_duplicate_keys(request_dict)
client.updateLdapAuthentication(**request_dict)

4. 启用Zeep调试日志排查问题

如果不确定问题出在哪里，可以开启Zeep的调试日志，查看请求转换的详细过程，这样能快速定位键重复或结构异常的环节：

import logging
logging.basicConfig(level=logging.DEBUG)

日志会打印Zeep将字典转换为SOAP元素的每一步，帮助你发现潜在的结构错误。

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