XmlSerializer序列化失败的根本原因是类型缺少无参构造函数、字段/属性访问受限或使用不支持的泛型集合；实操需确保public可写属性、避免Dictionary<string,object>、正确处理命名空间与静态复用实例。
XmlSerializer 序列化时抛出“无法序列化类型 XXX”错误
根本原因是 XmlSerializer 要求目标类型必须有无参构造函数，且所有要序列化的字段/属性不能是 readonly、不能是 internal 或 private set（除非用 [XmlElement] 显式标记），也不能是泛型集合（如 List<T> 本身可序列化，但 IEnumerable<T> 不行）。
实操建议：
- 检查类中是否存在
private readonly string _name;这类字段——改成自动属性public string Name { get; set; }，或加[XmlElement]并确保有 public setter - 避免用
Dictionary<string, object>直接序列化——它不支持 XML 序列化；改用XmlSerializer支持的类型，如List<KeyValuePair<string, string>>，或自定义包装类 - 如果类里有
DateTimeOffset字段，默认会序列化为带偏移的字符串（如2024-01-01T12:00:00+08:00），但反序列化时可能失败（.NET Framework 4.7.2 以前版本不支持）；稳妥做法是改用DateTime+[XmlAttribute]控制格式
用 XmlSerializer 反序列化 XML 字符串时返回 null 或抛出 InvalidOperationException
常见于 XML 根元素名与目标类型名不一致，或命名空间不匹配。例如 XML 是 <Person xmlns="http://example.com/ns">...，但没在 XmlSerializer 构造时传入对应 XmlRootAttribute。
实操建议：
- 确认 XML 字符串首尾无 BOM 或不可见空白——
XmlSerializer.Deserialize(new StringReader(xml.Trim()))更安全 - 如果 XML 含默认命名空间（
xmlns="xxx"），必须显式指定：var root = new XmlRootAttribute { ElementName = "Person", Namespace = "http://example.com/ns" };，再传给new XmlSerializer(typeof(Person), root) - 反序列化前建议先用
XDocument.Parse(xml)验证 XML 是否合法——避免把格式错误当成类型问题排查
需要控制 XML 输出格式：去掉 xsi:type、添加 CDATA、调整缩进
XmlSerializer 默认不生成 xsi:type，但如果你用了多态（如基类变量引用子类实例），又没用 [XmlInclude] 声明子类，就会静默失败或输出异常内容；CDATA 和缩进则需配合 XmlWriterSettings。
实操建议：
- 多态序列化必须加
[XmlInclude(typeof(Manager))]到基类上，否则子类字段会被忽略 - 想让某个字符串字段输出为 CDATA？不行——
XmlSerializer不支持。得换XmlDocument或XElement手动构建，或用IXmlSerializable自定义序列化逻辑 - 缩进和换行靠
XmlWriterSettings：new XmlWriterSettings { Indent = true, IndentChars = " ", NewLineChars = "\n" }，但注意：.NET Core 3.1+ 中XmlWriter.Create的settings.CloseOutput默认为true，若写入MemoryStream后立刻读取，需设为false或调用Flush()
XmlSerializer 性能差、初始化慢，高频调用场景怎么办
XmlSerializer 构造函数内部会动态生成并编译 C# 类（以 XmlSerializer*.dll 形式缓存在临时目录），首次调用耗时明显，尤其在 Web API 等短生命周期场景下容易被误判为“卡顿”。
实操建议：
- 务必复用
XmlSerializer实例——它是线程安全的，全局静态缓存一个即可：private static readonly XmlSerializer _serializer = new XmlSerializer(typeof(Order)); - 不要在方法内 new
XmlSerializer，哪怕加了typeof(T)缓存逻辑——反射开销大，且 .NET 已内置类型级缓存 - 如果真要极致性能（比如每秒数千次序列化），考虑改用
System.Text.Json（虽不直接支持 XML），或预生成序列化程序集（sgen.exe，仅限 .NET Framework）；不过绝大多数业务场景，复用实例已足够
最常被忽略的是命名空间处理和静态实例复用——这两个点不处理，调试时要么反序列化失败，要么压测时 CPU 突增，但错误日志里完全看不出关联。
