如何将XmlDocument的反序列化部分转换为对象？处理Web API返回的XML响应

我太懂这种尴尬了！每次调用API拿到这种套了一层通用状态的XML，想直接抓核心业务数据的时候，总觉得找不到精准的描述词来搜解决方案。先给你拆解两种高效处理这种结构的办法，不管你用哪种语言，思路都是通的~

先把你给出的XML补全一个完整示例，方便后续说明：

<?xml version="1.0"?>
<root>
  <status>
    <apiErrorCode>0</apiErrorCode>
    <apiErrorMessage/>
    <dbErrorCode>0</dbErrorCode>
    <dbErrorMessage/>
    <dbErrorList/>
  </status>
  <data>
    <modelName>UserProfile</modelName>
    <userId>12345</userId>
    <userName>JohnDoe</userName>
  </data>
</root>

方法一：定义嵌套模型类，完整反序列化后提取数据 #

这种方法适合你需要同时校验状态码（比如判断请求是否成功）的场景，用泛型类还能复用在所有同结构的API响应上。以C#为例：

先定义对应整个XML结构的类：

// 外层通用响应容器，用泛型适配不同业务数据
[XmlRoot("root")]
public class ApiResponse<T>
{
    [XmlElement("status")]
    public ApiStatus Status { get; set; }
    
    [XmlElement("data")]
    public T Data { get; set; }
}

// 对应status部分的状态类
public class ApiStatus
{
    [XmlElement("apiErrorCode")]
    public int ApiErrorCode { get; set; }
    
    [XmlElement("apiErrorMessage")]
    public string ApiErrorMessage { get; set; }
    
    [XmlElement("dbErrorCode")]
    public int DbErrorCode { get; set; }
    
    [XmlElement("dbErrorMessage")]
    public string DbErrorMessage { get; set; }
    
    [XmlElement("dbErrorList")]
    public string DbErrorList { get; set; }
}

// 你的业务数据类，根据实际XML结构调整
public class UserProfile
{
    [XmlElement("modelName")]
    public string ModelName { get; set; }
    
    [XmlElement("userId")]
    public int UserId { get; set; }
    
    [XmlElement("userName")]
    public string UserName { get; set; }
}

然后反序列化拿到业务数据，还能顺手做状态校验：

var serializer = new XmlSerializer(typeof(ApiResponse<UserProfile>));
using var reader = new StringReader(xmlResponse);
var apiResponse = (ApiResponse<UserProfile>)serializer.Deserialize(reader);

// 这就是你要的核心数据
var targetData = apiResponse.Data;

// 顺便校验请求是否成功
if (apiResponse.Status.ApiErrorCode != 0)
{
    // 处理错误逻辑，比如抛出异常或记录日志
    throw new Exception($"API请求失败：{apiResponse.Status.ApiErrorMessage}");
}

方法二：先提取data节点，再单独反序列化 #

如果你只关心<data>里的内容，不想定义外层的通用类，可以用XML解析工具先把目标节点抠出来再处理。还是以C#为例：

var xDoc = XDocument.Parse(xmlResponse);
// 找到第一个data节点
var dataNode = xDoc.Descendants("data").FirstOrDefault();

if (dataNode != null)
{
    var serializer = new XmlSerializer(typeof(UserProfile));
    using var reader = dataNode.CreateReader();
    var targetData = (UserProfile)serializer.Deserialize(reader);
}

小贴士 #

• 如果是其他语言（比如Python），思路完全一致：要么定义完整的模型类（用pydantic），要么用xml.etree.ElementTree通过XPath提取<data>节点再解析。
• 记得处理边界情况：比如<data>节点可能不存在，或者状态码非0的情况，避免空引用异常。
• 泛型容器类ApiResponse<T>可以复用在所有同结构的API上，一次定义终身受益。

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