ASP.NET Core MVC控制器返回空Excel文件问题求助

你的ASP.NET Core MVC（Umbraco项目）控制器返回的Excel文件为空，常见原因及解决办法如下：

1. 确保fileData已被枚举（避免延迟加载导致空数据） #

如果fileData是IQueryable类型（比如从EF Core获取的未执行查询），InsertData执行时可能因上下文已释放或未触发查询导致无数据。需提前将数据转为内存集合：

var fileData = _service.GetData(Id).ToList(); // 转为List<T>，确保数据已加载到内存

2. 重置流的位置（部分环境下的兼容性问题） #

虽然MemoryStream.ToArray()理论上会返回所有字节，但部分场景下保存后流指针停在末尾，可能导致读取异常。在workbook.SaveAs(stream)后添加指针重置：

workbook.SaveAs(stream);
stream.Position = 0; // 重置流指针到起始位置
var content = stream.ToArray();

3. 验证Excel生成逻辑（排除数据写入问题） #

在返回文件前，将生成的字节数组写入本地文件，确认Excel本身是否有数据：

System.IO.File.WriteAllBytes(@"D:\test_output.xlsx", content); // 写入本地验证

如果本地文件有数据，说明问题出在Umbraco的返回逻辑；如果本地文件也为空，需检查：

• fileData是否真的包含有效数据（调试时查看fileData.Count()）
• 表头写入是否成功（调试时查看worksheet.Cell(1,1).Value）
• InsertData是否正确执行（查看worksheet.RowsUsed().Count()是否大于1）

4. 调整Umbraco控制器的返回方式 #

如果你的控制器是SurfaceController，确保返回FileResult时未被Umbraco的视图渲染管道干扰。若使用UmbracoApiController，可尝试直接返回流而非字节数组：

workbook.SaveAs(stream);
stream.Position = 0;
return File(stream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "MyFile.xlsx");

5. 升级ClosedXML版本 #

旧版本的ClosedXML可能存在流写入bug，升级到最新稳定版本可解决部分兼容性问题。

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