Zeep 报错：Service not found – 解决方案

正如摘要所说，本文旨在解决在使用 Zeep 库连接 Microsoft Dynamics 365 Business Central (BC) SOAP Endpoint 时遇到的 “Service not found” 错误。以下将详细分析问题并提供解决方案。

问题分析

在使用 Zeep 库调用 Business Central 的自定义 SOAP Endpoint 时，可能会遇到 zeep.exceptions.Fault: Service “Company Name/Codeunit/MyOperation” was not found! 错误。 尽管使用 python3 -m zeep 命令可以成功获取 WSDL 定义，表明服务本身是可访问的，但通过 Zeep 代码调用时却失败了。

可能原因

根据提供的上下文信息以及 GitHub issue 的讨论，问题的根源可能在于 Zeep 库本身存在的一个缺陷。Zeep 在处理某些 SOAP 服务时，可能会错误地构建请求的 URL，导致服务无法找到。

解决方案

该问题在 Zeep 的 GitHub 仓库中已被报告并解决，修复方案是升级 Zeep 库到最新版本。

pip install zeep --upgrade

示例代码

以下是一个使用 Zeep 连接 Business Central SOAP Endpoint 的示例代码，确保将 BC_USER，BC_PASSWORD 和 url 替换为实际的值。

import os
from requests import Session
from requests.auth import HTTPBasicAuth
from zeep import Client
from zeep.transports import Transport
user = os.environ.get("BC_USER")
password = os.environ.get("BC_PASSWORD")
session = Session()
session.auth = HTTPBasicAuth(user, password)
url = "https://foo.bar/Company%20Name/Codeunit/MyOperation?WSDL" # ensure WSDL is appended
client = Client(url, transport=Transport(session=session))
try:
result = client.service.MyOperation(serialNo="baz")
print(result)
except Exception as e:
print(f"An error occurred: {e}")

注意事项

• WSDL URL: 确保提供的 URL 包含 ?WSDL 查询参数，以便 Zeep 能够正确解析服务的定义。
• 身份验证: 使用 requests.Session 和 HTTPBasicAuth 来处理身份验证，确保提供正确的用户名和密码。
• 异常处理: 使用 try…except 块来捕获潜在的异常，并打印有用的错误信息，方便调试。
• 参数名称: 确保调用服务时使用的参数名称与 WSDL 定义中定义的参数名称完全匹配。
• Zeep版本: 保持Zeep库为最新版本，以确保修复了已知的bug。

总结

当遇到 Zeep 报错 “Service not found” 时，首先应检查 URL 是否正确，包括是否包含 ?WSDL 参数。其次，确认身份验证配置正确。如果问题仍然存在，尝试升级 Zeep 库到最新版本。通过以上步骤，通常可以解决此问题，成功连接并调用 Business Central 的自定义 SOAP 服务。