XDocument.Load(Stream)易因流提前关闭或UTF-8 BOM导致ObjectDisposedException或XmlException；应避免手动关流、用StreamReader去BOM或XmlReader.Create宽容解析；异步需先读全再Parse，流位置和BOM是调试关键。
Load 时流已关闭导致 ObjectDisposedException
直接用 XDocument.Load(Stream) 读取完就关流，但 XML 解析可能延迟（比如用了 XElement.Descendants() 后才真正读），这时再访问节点就会崩出 ObjectDisposedException: Cannot access a closed Stream。
- 别在
Load前或后手动调用stream.Close()或stream.Dispose() - 让
XDocument自己管理流生命周期：传入未关闭的流，且不设leaveOpen: true（默认是false，即 Load 完会关流） - 如果必须复用流（比如后续还要读其他内容），显式传
leaveOpen: true：XDocument.Load(stream, LoadOptions.None, true);
- 更稳妥的做法是用
using包裹流，但确保所有 XML 操作都在using块内完成
UTF-8 BOM 导致根元素解析失败
从网络响应、文件或内存流加载 XML 时，若源带 UTF-8 BOM（EF BB BF），XDocument.Load 可能报 XmlException: Data at the root level is invalid，尤其在 .NET Framework 下更敏感。
- 不是编码声明问题（
<?xml version="1.0" encoding="utf-8"?>有无都一样） - 用
StreamReader预处理流，指定new UTF8Encoding(encoderShouldEmitUTF8Identifier: false)去掉 BOM - 或改用
XDocument.Load(XmlReader.Create(stream, new XmlReaderSettings { DtdProcessing = DtdProcessing.Ignore }))，它对 BOM 更宽容 - .NET 5+ 对 BOM 的容忍度提升，但跨平台部署时仍建议统一预处理
异步场景下不能直接用 LoadAsync 读流
XDocument 没有原生的 LoadAsync(Stream) 方法。有人试图用 Task.Run(() => XDocument.Load(stream)) 伪装异步，这反而增加线程开销，且无法取消。
- 真要异步加载，得先异步读取流为字节数组或字符串，再用
XDocument.Parse(string) - 例如：
var xmlBytes = await stream.ReadAsByteArrayAsync();<br>var doc = XDocument.Parse(Encoding.UTF8.GetString(xmlBytes));
- 注意大文件场景：
ReadAsByteArrayAsync会全量进内存，比流式解析更耗内存 - 若需流式 + 异步 + 低内存，改用
XmlReader.Create(stream)配合await reader.ReadAsync()手动构建树
Load 和 Parse 在流场景下的关键区别
看到别人用 XDocument.Parse(string) 成功，换成 Load(Stream) 就失败，往往卡在流位置或编码上。
-
Load(Stream)会从流当前位置开始读，如果流已被读过一部分（如 HTTP 响应流里提前看了 header），要先stream.Position = 0 -
Parse(string)不涉及流位置，但要求你先把流转成字符串——这时编码判断就很重要，错用Encoding.Default会导致中文乱码 -
Load内部会探测编码（看 BOM 或 XML 声明），Parse完全依赖你传入的字符串编码是否正确 - 调试时可先用
stream.CopyTo(new MemoryStream())抽取原始字节，用十六进制工具确认开头是不是 BOM 或标签
