使用iTextPDF将HTML转PDF时的GIF图片显示异常问题

使用iTextPDF将HTML转换为PDF时，多数内容转换正常，但有一张仅含透明背景和中心图像的静态GIF（非动图）转换后只显示轮廓，其他带透明背景的GIF转换均正常。

转换代码如下：

PdfWriter writer = new PdfWriter(inMemoryStream);
PdfDocument pdf = new PdfDocument(writer);
PdfMerger merger = new PdfMerger(pdf);
ByteArrayOutputStream baos = new ByteArrayOutputStream();
PdfDocument temp = new PdfDocument(new PdfWriter(baos));
HtmlConverter.convertToPdf(test, temp, converterProperties);
temp = new PdfDocument(new PdfReader(new ByteArrayInputStream(baos.toByteArray())));
merger.merge(temp, 1, temp.getNumberOfPages());
temp.close();
pdf.close();
inMemoryStream.close();

可能的解决方法： #

• 检查目标GIF的编码细节：该GIF可能使用了非标准的透明通道或颜色表配置，用图像编辑工具（如GIMP、Photoshop）重新导出，选择标准透明设置后再尝试转换。
• 调整转换配置：在converterProperties中添加图像相关配置，强制指定像素比或解码模式：

  converterProperties.setProperty(ConverterProperties.IMAGE_DEVICE_PIXEL_RATIO, "1.0");
  

• 替换图片格式：将该GIF转换为PNG格式（PNG对透明支持更稳定），在HTML中替换后再执行转换。
• 升级iText版本：确保使用最新稳定版iTextPDF（如7.2.x系列），旧版本可能存在特定GIF格式的解码bug。

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