.NET Core Open XML导出Excel文件损坏问题排查求助

嘿，我帮你梳理下用Open XML导出Excel时文件损坏的常见坑，结合你的代码片段来逐一分析：

1. 文件扩展名与格式不匹配 #

你代码里用的是.xls扩展名，但Open XML生成的是Office Open XML格式（也就是.xlsx）——这俩本质是完全不同的文件结构：.xls是旧二进制格式，.xlsx是压缩的XML格式。强行给Open XML生成的文件套.xls后缀，Excel打开时会识别为错误格式，直接提示损坏。

修复方案：

• 把文件名改成demo.xlsx
• 返回文件时设置正确的Content-Type：application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

2. Open XML文档未正确收尾 #

Open XML对文档的生命周期管理要求很严格，必须确保SpreadsheetDocument被正确关闭，否则流里会缺失关键的文件结构信息。从你的代码片段看，大概率是没做好这一步。

错误示例（你可能漏了的部分）：

var document = SpreadsheetDocument.Create(stream, SpreadsheetDocumentType.Workbook);
// 做了一些文档操作，但没调用Close()

正确写法（用using自动管理）：

using (var document = SpreadsheetDocument.Create(stream, SpreadsheetDocumentType.Workbook))
{
    // 必须初始化的核心结构：工作簿、工作表、表格数据
    var workbookPart = document.AddWorkbookPart();
    workbookPart.Workbook = new Workbook();

    var worksheetPart = workbookPart.AddNewPart<WorksheetPart>();
    worksheetPart.Worksheet = new Worksheet(new SheetData());

    // 关联工作表和工作簿
    var sheets = workbookPart.Workbook.AppendChild(new Sheets());
    sheets.AppendChild(new Sheet()
    {
        Id = workbookPart.GetIdOfPart(worksheetPart),
        SheetId = 1,
        Name = "Sheet1"
    });
}

3. 响应流位置没重置 #

如果用MemoryStream生成文档，写完内容后流的指针会停在末尾，直接返回给客户端的话，拿到的是空白/不完整的流，Excel自然识别为损坏。

修复方案：

var stream = new MemoryStream();
// 写入Open XML内容...

stream.Position = 0; // 把流指针重置到开头
return File(stream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "demo.xlsx");

4. 缺失Open XML核心结构 #

Open XML文档有严格的层级要求，必须包含Workbook→Sheets→Sheet→Worksheet→SheetData这些核心节点，哪怕是空表格也得正确初始化。如果少了任何一环，Excel都会判定文件损坏。

5. 不要错误返回下载链接（如果你的逻辑是直接导出） #

从代码里的URL = string.Format(...)来看，你可能想返回文件的下载链接？但如果是直接导出给用户，应该用File()方法直接返回流，而不是返回服务器上的文件路径。如果是生成文件到服务器再返回链接，要确保文件完全写入磁盘后再返回，并且验证文件路径的正确性。

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