.NET Framework迁移.NET 6后SOAP消息反序列化异常

问题场景 #

将.NET Framework应用迁移到.NET 6后，调用SOAP服务时出现反序列化异常：响应中的description和idLicenseAgreement元素未被正确赋值给agreement子类的对应属性，反而被存入基类messageBase的Any数组。移除messageBase基类后，反序列化恢复正常。

收到的SOAP响应核心片段：

<return>
    <description>Standard</description>
    <idLicenseAgreement>1234</idLicenseAgreement>
</return>

核心原因 #

.NET 6使用的Microsoft.Tools.ServiceModel.Svcutil工具生成代码时，自动给基类和子类的属性添加了Order排序属性，导致XML序列化匹配逻辑与.NET Framework版本不一致：

• .NET Framework生成的代码无Order属性，序列化器按元素名称匹配属性，忽略顺序，因此能正确识别子类属性。
• .NET 6生成的代码中，基类messageBase的Any属性标记为Order=0，子类agreement的description同样标记为Order=0。XML序列化器处理继承类时，会优先按Order顺序匹配基类成员，Any作为Order=0的通配属性，会捕获所有未被显式匹配的元素，导致子类属性被错误存入Any数组。

解决方案 #

方案1：移除自动生成的Order属性 #

手动修改生成的代理类代码，删除所有属性上的Order参数，还原为.NET Framework的匹配逻辑：

• 修改messageBase类：

  // 移除Order=0
  [System.Xml.Serialization.XmlAnyElementAttribute()]
  public System.Xml.XmlElement[] Any { ... }
  
  // 移除Order=1
  [System.Xml.Serialization.XmlElementAttribute(Form=System.Xml.Schema.XmlSchemaForm.Unqualified)]
  public string messageId { ... }
  

• 修改agreement类：

  // 移除Order=0
  [System.Xml.Serialization.XmlElementAttribute(Form=System.Xml.Schema.XmlSchemaForm.Unqualified)]
  public string description { ... }
  
  // 移除Order=1
  [System.Xml.Serialization.XmlElementAttribute(Form=System.Xml.Schema.XmlSchemaForm.Unqualified)]
  public long idLicenseAgreement { ... }
  

方案2：调整Order属性的顺序值 #

确保基类成员的Order值大于子类所有属性的Order值，让序列化器优先匹配子类属性：

• messageBase类的Any设为Order=2，messageId设为Order=3
• agreement类的description保留Order=0，idLicenseAgreement保留Order=1

方案3：调整Svcutil生成参数 #

使用/serializer:XmlSerializer参数生成代理类，该参数会生成与.NET Framework兼容的无Order属性的代码：

svcutil.exe /serializer:XmlSerializer <WSDL地址>

验证 #

修改完成后重新调用SOAP服务，验证agreement对象的description和idLicenseAgreement属性能正确赋值，未预期的XML元素仍会被存入messageBase的Any数组中，与.NET Framework下的行为一致。

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