XDocument.Load(TextReader)抛“根元素缺失”异常的根本原因是TextReader当前位置非起始，导致解析器从中间读取XML；应确保其位于开头，或改用XDocument.Parse()或Load(Stream)。
为什么 XDocument.Load(TextReader) 会抛出“根元素缺失”异常
根本原因不是文本内容真没根节点，而是 TextReader 当前位置不为开头（比如已调用过 ReadLine() 或 Peek()），导致 XML 解析器从中间开始读，自然看不到 <?xml 声明或根标签。XML 解析器不会自动 rewind，它只认当前位置。
- 常见错误场景：把
StringReader先用于预处理（如日志打印、条件判断），再传给XDocument.Load() - 安全做法：始终确保
TextReader位于起始位置 —— 对StringReader没法Seek()，只能新建；对StreamReader可调用BaseStream.Position = 0（前提是流支持定位） - 若流不可定位（如网络响应流、管道流），别用
TextReader包装后传入Load()，改用XDocument.Load(Stream)或先读全量字符串再用XDocument.Parse(string)
XDocument.Load(TextReader) 和 XDocument.Parse(string) 性能与内存差异
前者是流式解析，理论上更省内存；后者必须先把整个字符串加载进托管堆。但实际中，如果 TextReader 是 StringReader，底层仍是读内存字符串，性能几乎无差别，反而多一层抽象；而 Parse() 更直观、可控，且能明确捕获 XmlException 中的行号列号。
- 用
Load(TextReader)的合理场景：对接StreamReader读取大文件或网络响应，且你确定流可定位或已重置 - 避免在日志/调试中临时构造
StringReader再传给Load()—— 直接用Parse()更干净 -
Parse()对 BOM 敏感：含 UTF-8 BOM 的字符串可能触发“无法识别的字符”错误；Load(Stream)能自动探测编码，Load(TextReader)则完全依赖TextReader自身的编码设定
如何安全地从任意 TextReader 加载 XDocument（含 StreamReader 示例）
关键不是“怎么调用”，而是“怎么准备流”。尤其 StreamReader 默认不支持 Seek()，除非构造时显式传入可定位的 Stream 并设 leaveOpen = true。
- 正确示例：
var stream = File.OpenRead("data.xml"); var reader = new StreamReader(stream, Encoding.UTF8) { BaseStream.Position = 0 }; var doc = XDocument.Load(reader); - 错误示例：
var reader = new StreamReader("data.xml"); XDocument.Load(reader);—— 此时BaseStream.Position可能非零，且StreamReader构造后内部缓冲区已预读 - 最稳妥兜底方案：不管什么
TextReader，先reader.ReadToEnd()得到字符串，再用XDocument.Parse()—— 适合中小 XML，代价是多一次字符串拷贝
编码不匹配导致的乱码或解析失败
XDocument.Load(TextReader) 完全信任 TextReader 返回的字符，不做二次编码检测。如果 TextReader 的编码和 XML 声明（如 <?xml version="1.0" encoding="GBK"?>）不一致，就会出现中文乱码，甚至因非法字符提前终止解析。
- 不要依赖 XML 声明里的
encoding属性 ——TextReader已经按自己设定的编码解码完了，声明只是摆设 - 构造
StreamReader时，显式传入正确Encoding（如Encoding.GetEncoding("GB2312")），而不是用默认构造函数 - 若 XML 来源不可控（如第三方 API 响应），优先用
HttpWebResponse.GetResponseStream()+XDocument.Load(Stream)，让 .NET 自动根据 HTTP Header 或 BOM 推断编码
TextReader 的状态是否干净 —— 它不像字符串那样“无副作用”，每次读取都会移动位置，而且这个位置没法靠“重新传参”重置。 
