调用第三方SOAP服务时出现KVPfield[]转KVPfield类型转换错误

这种情况大概率是WSDL定义的数组序列化规则和服务端实际期望的格式不匹配，或者工具生成代码时的序列化特性处理有误，以下是具体原因和解决方法：

可能的原因 #

1. WSDL的数组定义不规范
   第三方SOAP服务的WSDL通常有两种数组定义方式：

   • 一种是用<xs:element name="searchFields" type="tns:KVPfield" maxOccurs="unbounded"/>，属于「重复单个元素」，工具生成的C#代码会是KVPfield[]，但序列化时会输出多个<searchFields>节点；
   • 另一种是用<xs:element name="searchFields" type="tns:KVPfieldArray"/>（KVPfieldArray是包含多个KVPfield的数组类型），序列化时会输出一个<searchFields>容器节点，里面包含多个<KVPfield>子节点。
     如果服务端实际期望第二种格式，但WSDL写的是第一种，就会出现「数组转单个对象」的错误——服务端把多个<searchFields>节点当成了单个对象的重复赋值，自然解析失败。

2. 自动生成代码的序列化特性错误
   .NET的WCF工具导入WSDL时，可能会把「重复元素」错误识别成数组，但序列化特性用的是[XmlElement]而非[XmlArray]，导致发送的XML结构不符合服务端预期。

3. 第三方服务的WSDL与实际接口不一致
   部分服务商的WSDL文档更新不及时或本身存在错误，实际接口期望单个KVPfield对象，但WSDL里误写成了数组类型。

解决步骤 #

• 检查自动生成的代码
  找到生成的OrderRequest类，查看searchFields属性的序列化特性：

  // 错误情况：生成多个<searchFields>节点
  [XmlElement(ElementName = "searchFields")]
  public KVPfield[] searchFields { get; set; }
  
  // 修改为容器数组格式：生成<searchFields>包含多个<KVPfield>子节点
  [XmlArray("searchFields")]
  [XmlArrayItem("KVPfield")]
  public KVPfield[] searchFields { get; set; }
  

  修改后重新编译调用，验证问题是否解决。

• 抓包验证请求格式
  用Fiddler或开启WCF消息日志，查看发送的SOAP请求XML结构，对比服务端提供的示例请求（若有）：

  • 错误请求结构：

    <OrderRequest>
      <fMethod>xxx</fMethod>
      <searchFields><fKey>key1</fKey><fValue>val1</fValue></searchFields>
      <searchFields><fKey>key2</fKey><fValue>val2</fValue></searchFields>
    </OrderRequest>
    

  • 服务端期望的正确结构：

    <OrderRequest>
      <fMethod>xxx</fMethod>
      <searchFields>
        <KVPfield><fKey>key1</fKey><fValue>val1</fValue></KVPfield>
        <KVPfield><fKey>key2</fKey><fValue>val2</fValue></KVPfield>
      </searchFields>
    </OrderRequest>
    

  若结构不符，调整序列化特性即可修正。

• 确认WSDL的正确性
  如果上述方法无效，直接联系第三方服务提供商，索要正确的请求示例，或让他们核对WSDL定义是否与实际接口一致——很多时候问题根源是服务商的WSDL写错了。

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