C#使用ExcelPackage读取Excel工作表时触发XML声明错误问题

API 探路者

2026-8-29

问题根因

这个报错和你手动修改内存中XML声明的操作没有直接关系，核心原因是你加载的源xlsx文件不符合Open XML规范：

Excel的xlsx本质是zip压缩包，内部xl/workbook.xml文件要求XML声明必须是整个文件的第一个节点，前面不能存在任何空白字符、BOM头、不可见特殊字符、重复声明，否则底层XML解析器会直接抛出异常
你之前尝试修改xlPack.Workbook.WorkbookXml的操作完全无效：EPPlus采用懒加载机制，new ExcelPackage时不会解析内部XML结构，第一次访问Workbook.Worksheets（甚至访问WorkbookXml本身）时才会触发解析，格式错误会在解析瞬间抛出，你写的删除旧声明、插入新声明的代码根本没有执行机会
你贴的XML结构示例本身就是非法格式：命名空间的URL没有加引号，这类语法错误也会导致解析器抛出定位不准的异常，误导你以为是XML声明位置的问题

排查步骤

按顺序操作可以快速定位具体损坏点：

把待加载的importFile后缀改为.zip，解压后找到xl/workbook.xml文件，用纯文本编辑器（VS Code、Notepad++均可，不要用Word这类富文本编辑器）打开
跳到文件最开头，检查是否存在以下问题：
- <?xml version="1.0" encoding="UTF-8" standalone="yes"?>声明前有空格、换行、乱码、不可见字符
- 文件内存在多个XML声明，第二个声明刚好出现在第二行位置（和报错提示的Line 2完全对应）
- <workbook>根节点的命名空间属性值没有加引号，和你贴的示例格式一致
不需要在内存中修改XmlDocument对象做测试，直接修改解压后的workbook.xml文件，保存后重新打包为zip改回xlsx后缀，如果能正常加载，就确认是源文件格式损坏问题

解决方案

根据你的使用场景选对应方案即可：

方案1：手动修复源文件（适合单文件、少量文件场景）
按照排查步骤找到workbook.xml的损坏点后，直接删除XML声明前的多余内容、删掉重复的XML声明、给所有属性值补上双引号，保存后重新打包为xlsx即可正常加载。
方案2：代码自动预处理（适合批量处理、无法手动修改源文件的场景）
在EPPlus加载文件前，先通过System.IO.Packaging类库预处理压缩包内的workbook.xml，自动修正格式错误，参考代码如下：

// 预处理损坏的xlsx文件
using (var package = Package.Open(importFile, FileMode.Open, FileAccess.ReadWrite))
{
    var workbookPart = package.GetPart(new Uri("/xl/workbook.xml", UriKind.Relative));
    string xmlContent;
    using (var reader = new StreamReader(workbookPart.GetStream(FileMode.Open, FileAccess.Read)))
    {
        xmlContent = reader.ReadToEnd();
    }
    // 修正1：截取从第一个合法XML声明开始的内容，删掉前面所有多余字符
    var firstDeclareMatch = Regex.Match(xmlContent, @"<\?xml[^?]*\?>");
    if (firstDeclareMatch.Success)
    {
        xmlContent = xmlContent.Substring(firstDeclareMatch.Index);
        // 修正2：删除后续重复出现的XML声明
        var allDeclares = Regex.Matches(xmlContent, @"<\?xml[^?]*\?>");
        for (int i = allDeclares.Count - 1; i > 0; i--)
        {
            xmlContent = xmlContent.Remove(allDeclares[i].Index, allDeclares[i].Length);
        }
        // 修正3：补全缺失的命名空间引号（匹配你贴的错误格式）
        xmlContent = xmlContent.Replace("xmlns:r=http://", "xmlns:r=\"http://")
                               .Replace("xmlns=http://", "xmlns=\"http://");
    }
    // 写回修正后的内容
    using (var writer = new StreamWriter(workbookPart.GetStream(FileMode.Create, FileAccess.Write)))
    {
        writer.Write(xmlContent);
    }
    package.Close();
}

// 预处理完成后再用EPPlus加载，可正常访问工作表
using (StreamWriter sw = new StreamWriter(filePath + exportFileName))
{
    using (ExcelPackage xlPack = new ExcelPackage(new FileInfo(importFile)))
    {
        var worksheets = xlPack.Workbook.Worksheets;
        // 后续业务逻辑
    }
}

方案3：上游根治
如果这个xlsx文件是其他程序/组件生成的，直接修正生成端的逻辑，保证输出的workbook.xml符合Open XML规范，从源头避免格式错误。

*注意：不要尝试通过修改EPPlus的WorkbookXml对象修复这类解析阶段的错误，解析失败时你根本拿不到有效的XmlDocument实例，所有修改操作都不会生效。

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