PDFBox 2.0.9将含透明属性PDF转为带alpha通道PNG时图表颜色丢失问题

问题原因 #

• 你使用的PDFBox版本如果低于2.0.30，存在已知的带透明度自定义颜色渲染缺陷，当填充色不属于PDF内置主调色板时，颜色映射逻辑会出错。
• 默认渲染参数未开启高精度颜色管理，带透明度的颜色混合计算精度不足，导致输出颜色和原PDF有偏差。
• 未指定统一的输出颜色空间，自定义专色、非sRGB颜色在转换时没有标准映射规则，出现颜色丢失。

解决方案 #

1. 优先升级PDFBox版本 #

将PDFBox及相关依赖（fontbox、xmpbox等）升级到2.0分支的最新稳定版（≥2.0.30），官方已修复绝大多数透明度、自定义颜色相关的渲染bug。

2. 调整转换代码，优化渲染参数 #

修改后的转换代码如下：

import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.rendering.ImageType;
import org.apache.pdfbox.rendering.PDFRenderer;
import java.awt.*;
import java.awt.image.BufferedImage;
import java.io.IOException;
import org.apache.pdfbox.pdmodel.graphics.color.OutputIntent;

public static BufferedImage convertPDF2Image(PDDocument pdf, int page) throws IOException {
    // 强制指定输出颜色空间为sRGB，统一自定义颜色映射规则
    pdf.getDocumentCatalog().getOutputIntents().add(OutputIntent.createDefaultOutputIntent());
    
    int dpi = 300; // 用于PPT建议设置300dpi，清晰度更高
    PDFRenderer renderer = new PDFRenderer(pdf);
    // 关闭子采样，避免低精度采样导致的颜色丢失
    renderer.setSubsamplingAllowed(false);

    // 如无需透明背景，推荐用ImageType.RGB，可避免透明通道混合异常
    BufferedImage image = renderer.renderImageWithDPI(page, dpi, ImageType.RGB);

    // 如需保留透明通道，替换为以下代码
    // BufferedImage image = renderer.renderImageWithDPI(page, dpi, ImageType.ARGB);

    // 开启高精度渲染配置
    Graphics2D g2d = image.createGraphics();
    g2d.setRenderingHint(RenderingHints.KEY_INTERPOLATION, RenderingHints.VALUE_INTERPOLATION_BICUBIC);
    g2d.setRenderingHint(RenderingHints.KEY_COLOR_RENDERING, RenderingHints.VALUE_COLOR_RENDER_QUALITY);
    g2d.setRenderingHint(RenderingHints.KEY_ALPHA_INTERPOLATION, RenderingHints.VALUE_ALPHA_INTERPOLATION_QUALITY);
    g2d.dispose();

    return image;
}

3. 导出优化 #

如果后续用ImageIO导出PNG文件，不要设置过高的压缩比，避免颜色信息损失。如果是直接插入PPT，300dpi的RGB格式图片显示效果最优，无需额外调整。

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