如何通过Azure API/M调用WCF SOAP端点？含HTTP卸载场景

一、基础API导入配置 #

• 登录Azure门户，进入目标API管理实例，选择「API」→「+ 添加API」
• 选择「WSDL」导入选项，填入WCF服务的外部HTTP/HTTPS端点（即HTTP卸载后的前端端点）
• 完成API基础信息配置（名称、显示名称等），API管理会自动解析WSDL并生成对应的调用入口，支持原生SOAP调用或SOAP-to-REST映射。

二、HTTP卸载场景下的核心配置 #

HTTP卸载（如通过Application Gateway实现SSL卸载）需确保API管理与后端WCF服务的通信适配，重点处理头部传递、协议匹配：

1. 传递客户端原始信息头部 #

WCF服务通常依赖*X-Forwarded-For*、*X-Forwarded-Proto*获取客户端真实IP和请求协议，需在API管理中添加入站策略传递这些头部：

• 进入API的「设计」页面，选择「入站处理」→「+ 添加策略」
• 添加「设置HTTP头部」策略，配置两项：
  • 头部名称：X-Forwarded-Proto，值：@(context.Request.OriginalUrl.Scheme)
  • 头部名称：X-Forwarded-For，值：@(context.Request.IpAddress)
• 保存策略，确保头部被正确转发至后端。

2. 适配后端服务协议与主机头 #

若WCF服务在卸载后使用HTTP协议，需调整API管理的后端配置：

• 在API的「设置」页面，将「后端」区域的「协议」设置为与后端一致（如HTTP）
• 若WCF服务要求特定主机头，添加「设置后端服务」和「设置头部」策略：

  <set-backend-service base-url="http://your-wcf-backend-internal-url" />
  <set-header name="Host" exists-action="override">
    <value>your-wcf-backend-hostname</value>
  </set-header>
  

3. 确保SOAP消息完整性 #

WCF服务依赖严格的SOAP信封结构，需避免API管理修改消息内容：

• 确认请求的*Content-Type*为text/xml或application/soap+xml，可添加「检查HTTP头部」策略强制验证：

  <check-header name="Content-Type" failed-check-httpcode="415" failed-check-error-message="Content-Type must be text/xml or application/soap+xml">
    <value>text/xml</value>
    <value>application/soap+xml</value>
  </check-header>
  

• 禁用不必要的REST转换策略（若选择保留原生SOAP调用），避免破坏SOAP信封结构。

三、测试与调试步骤 #

• 使用API管理内置的「测试」功能，直接发送符合WSDL规范的SOAP请求，验证响应是否正常
• 查看API管理的「监控」日志，检查请求路径、头部、协议是否正确传递至后端
• 排查后端WCF服务日志，确认*X-Forwarded-*头部已被接收，协议匹配无冲突

四、常见问题排查 #

• 400 Bad Request错误：检查SOAP信封的命名空间、方法名称是否与WSDL完全一致，确认API管理未修改消息内容
• 客户端IP无法获取：验证X-Forwarded-For头部已正确传递，同时确保WCF服务通过自定义MessageInspector读取该头部
• SSL/协议不匹配错误：确认API管理的后端协议设置与WCF服务实际使用的协议一致（卸载后后端用HTTP则无需HTTPS调用）

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