使用NPOI在C#中下载Excel文件后出现报错问题

使用C#结合NPOI为Excel模板添加下拉数据，本地测试时文件可正常下载，但部署到服务器后，下载时会弹出文件损坏的报错提示。实际报错后的文件仍能正常使用，但会影响用户体验。

报错表现：

• 提示“Excel无法打开文件‘Allocation Rule Template.xlsx’，因为文件格式或文件扩展名无效。请确认文件未损坏，并且文件扩展名与文件的格式匹配”；
• 点击“打开”后文件可正常访问。

处理代码 #

XSSFWorkbook hssfwb;

string path = Server.MapPath("~/Content/Uploads").ToString() + ConfigurationManager.AppSettings["PathAllocationRuleTemplate"].ToString();
string newpath = Server.MapPath("~/Content/Uploads").ToString() + ConfigurationManager.AppSettings["PathAllocationRule"].ToString();


using (FileStream file = new FileStream(path, FileMode.Open, FileAccess.Read))
{
    hssfwb = new XSSFWorkbook(file);
    file.Close();
}

// 填充下拉数据的逻辑

// 下载逻辑
using (FileStream file = new FileStream(newpath, FileMode.Create, FileAccess.Write))
{
    hssfwb.Write(file);
    file.Close();
}

System.Web.HttpResponse response = System.Web.HttpContext.Current.Response;
response.ClearContent();
response.Clear();
response.ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
response.AddHeader("Content-Disposition", "attachment; filename=Allocation Rule Template.xlsx");
response.TransmitFile(newpath);
response.Buffer = true;
response.Flush();            
response.End();

解决方案 #

1. 跳过临时文件，直接写入响应流 #

服务器环境下临时文件可能存在未完全写入、被占用等问题，直接将工作簿写入响应流可避免这类问题：

// 替换原下载部分代码
var response = System.Web.HttpContext.Current.Response;
response.Clear();
response.ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
response.AddHeader("Content-Disposition", "attachment; filename=Allocation Rule Template.xlsx");

using (var ms = new MemoryStream())
{
    hssfwb.Write(ms);
    ms.Seek(0, SeekOrigin.Begin);
    ms.CopyTo(response.OutputStream);
}

response.Flush();
response.End();

2. 确保临时文件唯一性 #

如果必须使用临时文件，生成唯一文件名防止多用户操作时文件被覆盖：

// 生成带GUID的唯一文件名
string newpath = Path.Combine(Server.MapPath("~/Content/Uploads"), $"AllocationRule_{Guid.NewGuid()}.xlsx");

3. 检查目录权限 #

确认服务器上~/Content/Uploads目录给IIS应用池身份分配了读写权限，避免文件写入不完整。

4. 统一NPOI版本 #

确保服务器部署的NPOI版本与本地开发环境一致，版本差异可能导致文件生成时出现隐性损坏。

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