Azure Function中iText7生成PDF内存溢出问题及优化咨询

针对你在Azure Function中使用iText7生成471人胸牌PDF时出现的内存溢出问题，以下是具体优化措施：

1. 复用HttpClient实例 #

当前循环内每次创建HttpClient会导致大量未释放的连接和额外内存开销，应将实例提升到循环外复用：

// 把HttpClient移到循环外，全局复用
using var client = new HttpClient();
for (int i = 0; i < people.Count; i++) {
    var person = people[i];
    // 移除循环内的HttpClient创建逻辑
    var bytes = await client.GetByteArrayAsync($"https://redacted.com/fetchBadgeImage?conferenceId={conferenceId}&userId={person.Id}");
    // ... 后续图片处理代码
}

2. 避免重复遍历列表获取索引 #

people.IndexOf(person)会在每次循环中遍历整个列表，既浪费CPU也增加内存压力，改用for循环直接获取索引：

for (int i = 0; i < people.Count; i++) {
    var person = people[i];
    log.LogInformation($"Generating badge {i} of {people.Count} for {person.FirstName} {person.LastName}");
    var pageNum = (i / 6) + 1;
    var colNum = i % 2 == 0 ? 0 : 1;
    var rowNum = 2 - (i % 6 / 2);
    // ... 后续排版代码
}

3. 优化图片加载与资源释放 #

• 直接从流加载图片，避免将整个字节数组长期驻留内存：

  using var imageStream = await client.GetStreamAsync($"https://redacted.com/fetchBadgeImage?conferenceId={conferenceId}&userId={person.Id}");
  ImageData qrImageData = ImageDataFactory.Create(imageStream);
  

• 显式释放图片资源：用using包裹Image实例，确保添加到文档后及时释放内存：

  using var qrImage = new Image(qrImageData)
      .ScaleAbsolute(size.Width, size.Height)
      .SetFixedPosition(pageNum, 18 + (colNum * 288), 72f + (size.Height * rowNum) + (.5f * rowNum), 1200);
  document.Add(qrImage);
  

• 开启图片压缩：在PdfWriter中设置压缩级别，减少PDF内部图片的内存占用：

  var writer = new PdfWriter(outputStream);
  writer.SetCompressionLevel(PdfWriter.BEST_COMPRESSION);
  using var finalDoc = new PdfDocument(writer);
  

4. 避免将整个PDF加载到内存 #

当前用MemoryStream存储完整PDF，调用outputStream.ToArray()会把所有字节加载到内存。直接将PDF写入响应流，跳过内存缓存：

// 替换原有的MemoryStream和FileContentResult逻辑
return new FileStreamResult(outputStream, "application/pdf") {
    FileDownloadName = "conference-badges.pdf"
};

5. 优化iText文档配置 #

• 开启SmartMode：原代码设置SetSmartMode(false)，该模式可自动优化PDF资源（如复用重复图片），应改为启用：

  using var finalDoc = new PdfDocument(new PdfWriter(outputStream).SetSmartMode(true));
  

• 手动控制页面创建：提前按需创建页面，避免iText后台生成临时对象的额外开销：

  // 提前创建所有需要的页面
  for (int page = 0; page < Math.Ceiling(people.Count / 6.0); page++) {
      finalDoc.AddNewPage();
  }
  

6. 分批刷新文档释放内存 #

每处理完一页（6个胸牌）就刷新文档到流，及时释放内存：

for (int i = 0; i < people.Count; i++) {
    // ... 生成单个胸牌代码
    if ((i + 1) % 6 == 0) {
        finalDoc.Flush(); // 刷新页面内容到流，释放内存
    }
}

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