我之前也碰到过一模一样的情况，大概率是你的API在输出Excel流的时候没处理到位，导致文件损坏了。下面是几个常见的排查方向和修复方法：

1. 重置内存流的位置（最常见原因） #

EPPlus生成Excel后，内存流的指针会停在流的末尾，如果直接返回这个流，实际输出的是空内容或者不完整的文件。你需要在返回前把流的位置重置到起始点：

using (var package = new ExcelPackage())
{
    // 这里是你构建Excel内容的代码，比如创建工作表、填充数据
    
    var stream = new MemoryStream();
    package.SaveAs(stream);
    stream.Position = 0; // 关键：把流指针移回开头
    return File(stream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "persons.xlsx");
}

2. 确认Content-Type是否正确 #

别用错MIME类型！针对.xlsx格式的文件，必须使用application/vnd.openxmlformats-officedocument.spreadsheetml.sheet，如果误用了旧的application/vnd.ms-excel（这是针对.xls格式的），也会导致Excel无法识别文件。

3. 确保资源正确释放 #

一定要用using语句包裹ExcelPackage和内存流，避免资源泄漏导致文件写入不完整：

using (var package = new ExcelPackage())
{
    var worksheet = package.Workbook.Worksheets.Add("Persons");
    // 填充数据到工作表的代码
    
    using (var stream = new MemoryStream())
    {
        package.SaveAs(stream);
        stream.Position = 0;
        return File(stream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "persons.xlsx");
    }
}

4. 检查EPPlus许可证设置（针对5.x及以上版本） #

如果你用的是EPPlus 5.x或更新版本，非商业用途需要明确设置许可证上下文，否则可能会有隐藏的文件生成异常：

// 可以放在Program.cs或者Startup的初始化代码里
ExcelPackage.LicenseContext = LicenseContext.NonCommercial;

如果是商业用途，记得购买并配置对应的商业许可证。

5. 本地保存测试定位问题 #

先把生成的Excel直接保存到本地磁盘，看看能不能正常打开：

package.SaveAs(new FileInfo(@"D:\test\persons.xlsx"));

如果本地文件能打开，说明问题出在API返回流的环节；如果本地也打不开，那就是你构建Excel内容的代码有问题，比如单元格数据类型错误、工作表名称包含非法字符等。

你可以先试试重置流位置这个方法，我当时就是靠这个解决的！

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