C#从DataTable生成.xlsx文件下载报错，求原因及解决方法

你希望通过HTTP请求下载DataTable生成的Excel文件，现有代码修改contentType后能生成.xls文件，但生成.xlsx文件时Excel报错：

Excel无法打开该.xlsx文件，因为文件格式无效。请验证文件未损坏且扩展名与文件格式匹配。

你的代码如下：

private void DownloadExcel(DataSet ds, string excelFileNameNowDateTime)
{
    System.IO.StringWriter tw = new System.IO.StringWriter(); ;
    System.Web.UI.HtmlTextWriter hw = new System.Web.UI.HtmlTextWriter(tw);

    System.Web.UI.WebControls.DataGrid dgGrid = new System.Web.UI.WebControls.DataGrid();

    dgGrid.DataSource = ds.Tables[0];

    // Get the HTML for the control.
    dgGrid.HeaderStyle.Font.Bold = false;
    dgGrid.DataBind();
    dgGrid.RenderControl(hw);

    string contentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
    //string contentType = "application/vnd.ms-excel";
    Response.ContentType = contentType;
    this.EnableViewState = true;
    Response.Clear();
    //Response.ContentEncoding = System.Text.Encoding.Default;
    Response.AddHeader("content-disposition", String.Format(@"attachment; filename={0}", excelFileNameNowDateTime + ".xlsx"));

    Response.Write(tw.ToString());
    CloseHTTPResponse();
}

原因分析 #

核心问题是：你的代码本质是输出HTML表格文本，只是修改了contentType响应头和文件扩展名，并没有生成符合OpenXML规范的真正.xlsx文件。

• .xls（旧版二进制Excel格式）能打开是因为Excel有兼容容错机制，可以识别HTML内容并尝试解析成表格，但这并非标准的xls格式。
• .xlsx是基于OpenXML的压缩包格式，要求文件内容必须是符合规范的XML结构压缩包，你输出的纯HTML文本和xlsx格式完全不匹配，所以Excel直接判定格式无效。

解决办法 #

必须使用专门的库生成标准的OpenXML格式.xlsx文件，以下是两种常用方案：

方案1：使用EPPlus（推荐，适合服务器环境） #

EPPlus是轻量的OpenXML操作库，无需安装Excel，直接通过NuGet安装即可（.NET Framework选4.x版本，.NET Core/.NET 5+选最新版）。示例代码：

private void DownloadExcel(DataSet ds, string excelFileNameNowDateTime)
{
    using (var excelPackage = new ExcelPackage())
    {
        // 创建工作表
        var worksheet = excelPackage.Workbook.Worksheets.Add("数据表格");
        // 将DataTable导入工作表（true表示包含表头）
        worksheet.Cells["A1"].LoadFromDataTable(ds.Tables[0], true);
        
        // 设置响应信息
        Response.Clear();
        Response.ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
        Response.AddHeader("content-disposition", $"attachment; filename={excelFileNameNowDateTime}.xlsx");
        
        // 输出文件流
        Response.BinaryWrite(excelPackage.GetAsByteArray());
        Response.End();
    }
}

方案2：使用ClosedXML #

同样是基于OpenXML的轻量库，用法类似EPPlus，适合快速生成Excel文件。

注意事项 #

• 服务器环境下禁止使用Microsoft.Office.Interop.Excel，该库依赖本地安装的Excel软件，容易引发权限问题、进程残留等故障。
• 确保项目中已安装对应库的NuGet包，否则代码无法编译。

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