ASP.NET MVC多PDF文件打包Zip后无法下载问题排查

核心问题 #

ASP.NET MVC 4.8项目中，批量生成PDF并打包为Zip下载时，少量文件（3-4个以内）可正常下载，但文件数量超过阈值后下载失败。已排除文件大小影响（单个大文件打包正常），本地生成的Zip文件完整可用，同类项目运行无异常，且已调整web.config请求大小限制。

可行解决方案 #

1. 禁用响应缓冲并优化流操作

多文件打包时，内存缓冲可能因累积数据触发限制，同时WriteTo方法不如CopyTo可靠。修改代码如下：

[HttpPost]
public ActionResult UploadCsv(HttpPostedFileBase InputCsvFile)
{
    // 禁用响应缓冲，避免内存溢出
    Response.BufferOutput = false;
    
    // ...OTHER CODE...

    var memoryStream = new MemoryStream();

    using (var archive = new ZipArchive(memoryStream, ZipArchiveMode.Create, true))
    {
        foreach (var pdf in items)
        {
            var entry = archive.CreateEntry(pdf.PdfName);

            using (var entryStream = entry.Open())
            using (var fileStream = new MemoryStream(pdf.Pdf))
            {
                // 用CopyTo替代WriteTo，流操作更稳定
                fileStream.CopyTo(entryStream);
            }
        }
    }

    memoryStream.Position = 0;
    return File(memoryStream, "application/zip", zipFolderName);
}

2. 改用临时文件替代内存流

多文件场景下，MemoryStream在内存中累积数据可能触发ASP.NET内存限制，改用本地临时文件中转：

[HttpPost]
public ActionResult UploadCsv(HttpPostedFileBase InputCsvFile)
{
    // ...OTHER CODE...

    // 创建临时Zip文件
    string tempZipPath = Path.Combine(Path.GetTempPath(), $"{Guid.NewGuid()}.zip");
    using (var fileStream = new FileStream(tempZipPath, FileMode.Create))
    {
        using (var archive = new ZipArchive(fileStream, ZipArchiveMode.Create, true))
        {
            foreach (var pdf in items)
            {
                var entry = archive.CreateEntry(pdf.PdfName);
                using (var entryStream = entry.Open())
                using (var pdfStream = new MemoryStream(pdf.Pdf))
                {
                    pdfStream.CopyTo(entryStream);
                }
            }
        }
    }

    // 读取临时文件并返回，下载后清理
    var zipBytes = System.IO.File.ReadAllBytes(tempZipPath);
    System.IO.File.Delete(tempZipPath);
    return File(zipBytes, "application/zip", zipFolderName);
}

3. 调整超时与分块传输设置

• 增大web.config中的executionTimeout到更大值（如300），避免多文件处理超时：

  <httpRuntime targetFramework="4.8" executionTimeout="300" maxRequestLength="52428800" />
  

• 在Action中添加分块传输头，优化大响应输出：

  Response.AddHeader("Transfer-Encoding", "chunked");
  

4. 排查PDF生成环节资源泄漏

批量生成PDF时，若存在未正确释放的资源（如打印机上下文、未关闭的流），可能导致后续打包环节异常。确保PDF生成代码中所有资源都通过using语句或手动释放。

5. 检查IIS快速失败保护

IIS站点的"快速失败保护"可能因短时间内资源占用过高终止进程，可暂时禁用该功能或调整阈值测试。

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