使用EPPlus在.NET中生成下载.xlsx文件时Excel打开报错的原因

• 响应内容类型错误：没有设置正确的Content-Type头。必须指定为application/vnd.openxmlformats-officedocument.spreadsheetml.sheet，如果用了application/excel这类旧类型，浏览器可能会错误处理文件，导致损坏。

• 流操作不当：

  • 保存ExcelPackage到内存流后，没有将流的位置重置为0（stream.Position = 0），导致写入响应的是流的末尾空数据，文件实际内容不完整。
  • 没有正确释放ExcelPackage资源（比如没放在using块里），导致文件结构没有正确闭合，不符合OpenXML规范。

• 响应头配置错误：

  • Content-Disposition头设置不正确，比如没加attachment标记，或者文件名格式有问题，导致浏览器保存的文件扩展名和实际内容不匹配。
  • 文件名包含特殊字符（比如乱码、特殊符号），导致Excel解析时识别失败。

• EPPlus许可或版本问题：

  • EPPlus 5及以上版本有商业许可限制，如果未授权就使用了商业功能（比如加密、高级样式），生成的文件会被标记为无效。
  • 生成Excel的逻辑有误，比如工作表创建异常、单元格赋值错误，导致文件结构不符合xlsx格式要求。

参考修正代码（ASP.NET Core示例） #

using (var package = new ExcelPackage())
{
    var sheet = package.Workbook.Worksheets.Add("DemoSheet");
    sheet.Cells["A1"].Value = "测试数据";
    
    var stream = new MemoryStream();
    package.SaveAs(stream);
    stream.Position = 0; // 关键：重置流位置
    
    Response.Headers.Add("Content-Disposition", "attachment; filename=SampleData.xlsx");
    return File(stream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
}

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