在C#开发中，将XML转换为JSON是常见需求，尤其是在处理Web API、配置文件或跨平台数据交换时。虽然.NET提供了多种工具来实现这一功能，但在实际使用中容易遇到格式不一致、命名冲突、类型丢失等问题。以下是高效解析并转换XML到JSON的方法，以及常见错误与对应解决方案。
1. 使用 Newtonsoft.Json 进行 XML 到 JSON 转换
最常用且稳定的方式是结合 System.Xml 和 Newtonsoft.Json（也称 Json.NET）库。通过 XmlDocument 读取XML，再利用 JsonConvert.SerializeXmlNode() 实现转换。
示例代码：
using System.Xml;
using Newtonsoft.Json;
string xml = @"<person>
<name>张三</name>
<age>30</age>
<isStudent>false</isStudent>
</person>";
XmlDocument doc = new XmlDocument();
doc.LoadXml(xml);
string json = JsonConvert.SerializeXmlNode(doc, Newtonsoft.Json.Formatting.Indented);
Console.WriteLine(json);
输出结果为标准JSON格式：
{
"person": {
"name": "张三",
"age": "30",
"isStudent": false
}
}
该方法简洁高效，支持嵌套结构和属性处理。
2. 常见错误与解决方案
错误1：文本节点与元素混淆导致JSON结构异常
当XML包含混合内容（如文本与子元素共存），默认转换可能生成不符合预期的JSON。
问题XML示例：
<description>这是一个<color>红色</color>的苹果</description>
直接转换后可能产生 #text 字段，影响可读性。
解决方案：
使用 SerializeXmlNode(doc, Formatting.None, true) 的第三个参数设置为 true，忽略空节点和文本包装。 若需精细控制，先预处理XML，拆分混合内容或使用LINQ to XML重构结构。错误2：数字或布尔值被序列化为字符串
XML本身无类型概念，所有值均为字符串。默认转换下，
<age>30</age>会变成
"age": "30"，而非数值。
解决方案：
启用 WriteArrayAttribute 并配合类型推断机制。 更有效方式是在反序列化前手动处理节点，或使用自定义转换逻辑。 推荐做法：在目标系统接收JSON后做类型转换，或在C#端使用JObject后遍历修正类型。示例：自动识别基本类型
JObject jObj = JObject.Parse(json);
foreach (var prop in jObj["person"].Children())
{
if (prop is JProperty p)
{
if (int.TryParse(p.Value?.ToString(), out int i))
p.Value = i;
else if (bool.TryParse(p.Value?.ToString(), out bool b))
p.Value = b;
}
}
错误3：根节点缺失或重复导致数组处理失败
多个同名元素应转为JSON数组，但若未正确包裹，会丢失结构。
错误XML：
<person><item>A</item><item>B</item></person>
期望输出：
"item": ["A", "B"]
解决方案：
确保XML结构合理，多个子项应在同一父级下。 使用 XmlDocument + JsonConvert 可自动识别重复子元素并转为数组。 避免使用无根节点的XML片段；如有必要，手动添加临时根节点。错误4：XML声明或命名空间引起解析异常
带有
<?xml version="1.0"?>或命名空间（xmlns）的文档可能导致加载失败或字段带前缀。
解决方案：
使用 XmlDocument.LoadXml() 支持完整XML声明。 处理命名空间时，可用 XmlNamespaceManager 忽略或映射前缀。 如无需保留命名空间，读取前用正则替换移除 xmlns 属性（谨慎使用）。性能优化建议
对大批量XML转换，考虑使用 XDocument 替代 XmlDocument，内存占用更低。 缓存重复使用的转换逻辑，避免频繁创建对象。 异步处理大文件：读取文件时使用 async/await 防止阻塞主线程。 优先使用 JsonSerializerSettings 统一配置，如日期格式、缩进等。基本上就这些。只要注意结构规范、类型处理和边界情况，C#中的XML到JSON转换可以既高效又可靠。关键是选择合适的工具链并提前处理典型陷阱。
