iTextSharp转换WMF文件为PDF时卡顿问题排查与解决

可能的原因及对应解决措施： #

1. 目标WMF文件异常

• 原因：文件损坏、内容包含复杂矢量元素（如大量路径、嵌入字体），或是文件尺寸过大，导致iText解析时耗时剧增。即使代码未改动，也可能是新处理的WMF文件本身出现问题。
• 解决：
  • 先验证WMF文件完整性：用系统画图工具打开，确认能正常渲染；
  • 对复杂/大尺寸WMF，转成位图后再插入PDF，降低矢量解析压力：

    using (Image wmfImg = ImgWMF.GetInstance(wmfFile))
    using (Bitmap bmp = new Bitmap(wmfImg.Width, wmfImg.Height))
    using (Graphics g = Graphics.FromImage(bmp))
    {
        g.Clear(Color.White);
        g.DrawImage(wmfImg, 0, 0);
        // 转为iText可用的Image实例
        img1 = Image.GetInstance(bmp);
    }
    

2. iText库的WMF解析性能瓶颈

• 原因：所用iText版本存在特定WMF解析的性能缺陷，或是环境变化触发了未被发现的解析逻辑问题。
• 解决：
  • 升级iText相关依赖到最新稳定版，修复已知的性能bug；
  • 替换WMF解析方式，用System.Drawing直接处理WMF，再转为iText兼容的Image对象，绕过iText自带的WMF解析逻辑。

3. 文件资源未正确释放或磁盘IO异常

• 原因：代码中FileStream、Image等资源未用using包裹，导致句柄泄漏或资源占用；或是目标磁盘空间不足、读写速度异常，造成文件写入卡顿。另外，File.Delete(wmfFile)执行过早，可能iText仍在占用WMF文件句柄，间接引发卡顿。
• 解决：
  • 用using包裹所有实现IDisposable的对象，自动释放资源：

    using (Image img1 = ImgWMF.GetInstance(wmfFile))
    using (var fs = new FileStream(pdfFile, FileMode.Create, FileAccess.ReadWrite))
    {
        img1.SetAbsolutePosition(0, 0);                
        img1.ScaleAbsolute(PageSize.A4.Height, PageSize.A4.Width - 10);
    
        Document pdfDoc = new Document(new Rectangle(PageSize.A4.Height, PageSize.A4.Width));
        PdfWriter.GetInstance(pdfDoc, fs);
    
        pdfDoc.Open();
        pdfDoc.Add(img1);
        pdfDoc.Close();
    }
    // 确保资源释放后再删除WMF文件
    File.Delete(wmfFile);
    

  • 检查目标磁盘剩余空间，测试将PDF输出到其他磁盘验证是否仍卡顿。

4. 内存不足或GC频繁触发

• 原因：如果是批量转换场景，可能存在内存泄漏，导致GC频繁回收；单个文件转换时，WMF转成Image后占用内存过大，引发内存压力。
• 解决：
  • 严格用using管理所有可释放资源，避免内存泄漏；
  • 监控程序运行时内存占用，排查泄漏点；
  • 对超大WMF文件，若支持分块处理则拆分后再转换。

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