.NET 7 Web API XML请求体无法反序列化问题求助

1. XML元素大小写不匹配 #

你使用的AddXmlSerializerFormatters()默认启用XmlSerializer，它对XML元素名称的大小写严格匹配。模型属性是大驼峰格式（如CurrentTime），但请求体中的XML元素是小驼峰（currentTime），导致属性无法映射，最终得到默认值的空对象。

解决方式二选一：

• 修改XML请求体，将元素名改为与模型属性一致的大驼峰：

  <TimeConfig>
      <CurrentTime>2023-01-20T22:41:26.558Z</CurrentTime>
      <IsNtpEnabled>true</IsNtpEnabled>
      <NtpServer>string</NtpServer>
  </TimeConfig>
  

• 给模型属性添加[XmlElement]特性，指定匹配的小驼峰元素名：

  public class TimeConfig
  {
      [XmlElement("currentTime")]
      public DateTimeOffset CurrentTime { get; set; }
      [XmlElement("isNtpEnabled")]
      public bool IsNtpEnabled { get; set; }
      [XmlElement("ntpServer")]
      public string? NtpServer { get; set; }
  }
  

2. 切换序列化器适配格式 #

如果倾向使用DataContractSerializer，需确保配置和模型特性匹配：

• 在Startup中启用AddXmlDataContractSerializerFormatters()；
• 给模型添加[DataContract]特性，属性添加[DataMember(Name = "xxx")]指定映射的元素名：

  [DataContract]
  public class TimeConfig
  {
      [DataMember(Name = "currentTime")]
      public DateTimeOffset CurrentTime { get; set; }
      [DataMember(Name = "isNtpEnabled")]
      public bool IsNtpEnabled { get; set; }
      [DataMember(Name = "ntpServer")]
      public string? NtpServer { get; set; }
  }
  

  这种配置下，小驼峰的XML元素就能正确映射到模型属性。

3. .NET 7未取消XML支持 #

.NET 7完全保留了XML序列化的相关API，只是默认未启用，需要通过AddXmlSerializerFormatters()或AddXmlDataContractSerializerFormatters()显式添加，你之前的配置方向正确，问题出在序列化器与请求体格式不匹配。

• 启用模型绑定日志：在appsettings.json中添加日志配置，查看解析失败的具体原因：

  {
    "Logging": {
      "LogLevel": {
        "Microsoft.AspNetCore.Mvc.ModelBinding": "Debug"
      }
    }
  }
  

  运行后日志会输出模型绑定的详细过程，包括元素不匹配等错误信息。
• 手动读取原始请求体：在控制器方法中直接读取请求体内容，确认是否和预期一致：

  using var reader = new StreamReader(Request.Body);
  var rawBody = await reader.ReadToEndAsync();
  // 输出rawBody验证内容格式
  

• 检查请求头与格式：确保Content-Type设置为application/xml或text/xml，请求体XML结构无语法错误。

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