使用PDFBox的PDFRenderer.renderImage转PDF为图片失败，结果不符

使用PDFBox的PDFRenderer.renderImage方法将PDF转换为图片时，出现渲染异常：生成的图片与原PDF显示效果不一致，部分背景色未被正确渲染。

效果对比 #

• 预期效果：
  
• 实际输出：
  

原PDF文件为github仓库中的hk.pdf。

解决办法 #

1. 确保开启注解渲染 #

若PDF背景色通过表单域注解实现，需显式开启注解渲染：

PDFRenderer renderer = new PDFRenderer(document);
renderer.setRenderAnnotations(true);
// 按需求设置DPI缩放比例，2.0f对应2倍分辨率
BufferedImage image = renderer.renderImage(pageIndex, 2.0f);

2. 优化渲染参数与背景填充 #

添加渲染提示提升画质，并手动填充背景色（若预期背景为白色）：

RenderingHints hints = new RenderingHints(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);
hints.put(RenderingHints.KEY_RENDERING, RenderingHints.VALUE_RENDER_QUALITY);

PDFRenderer renderer = new PDFRenderer(document);
renderer.setRenderingHints(hints);

BufferedImage image = renderer.renderImage(pageIndex, 2.0f);
// 手动填充白色背景
Graphics2D g2d = image.createGraphics();
g2d.setColor(Color.WHITE);
g2d.fillRect(0, 0, image.getWidth(), image.getHeight());
g2d.drawImage(image, 0, 0, null);
g2d.dispose();

3. 升级PDFBox版本 #

旧版本可能存在颜色渲染兼容性问题，建议升级至最新稳定版（如2.0.x系列）。

4. 处理特殊颜色空间 #

若PDF使用DeviceN等特殊颜色空间，需添加PDFBox相关依赖（如pdfbox-tools），并确保渲染时启用完整颜色转换支持。

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