PDFBox 2.0.20转PDF为图片时出现源栅格波段与色彩空间组件不匹配异常

问题场景 #

使用PDFBox 2.0.20的renderImageWithDPI方法转换PDF页面为RGB图片时，抛出如下异常：

Exception in thread "main" java.lang.IllegalArgumentException: Numbers of source Raster bands and source color space components do not match
at java.awt.image.ColorConvertOp.filter(ColorConvertOp.java:493)
at com.sun.imageio.plugins.jpeg.JPEGImageReader.acceptPixels(JPEGImageReader.java:1292)
...
at org.apache.pdfbox.rendering.PDFRenderer.renderImageWithDPI(PDFRenderer.java:229)

该异常源于PDF中某张JPEG图片的波段数与色彩空间组件不匹配，对应PDFBOX-3637工单。

解决思路 #

• 优先升级PDFBox版本：PDFBOX-3637问题在2.0.21及后续版本已被修复，直接升级到最新的2.0.x稳定版，就能彻底解决这个JPEG解码时的色彩空间不匹配问题。
• 临时异常处理方案：如果暂时无法升级版本，可在代码中捕获该异常，针对问题页面换用灰度模式渲染，或者跳过该页面：

try {
    BufferedImage bim = pdfRenderer.renderImageWithDPI(page, 300, ImageType.RGB);
    // 正常处理图片逻辑
} catch (IllegalArgumentException e) {
    if (e.getMessage().contains("Numbers of source Raster bands and source color space components do not match")) {
        // 尝试灰度模式渲染
        BufferedImage bim = pdfRenderer.renderImageWithDPI(page, 300, ImageType.GRAY);
        // 处理灰度图片
    } else {
        throw e;
    }
}

• 修复PDF中的问题图片：如果PDF本身存在图片色彩空间定义错误，可提前遍历PDF中的图片资源，重新解码并替换异常图片：

// 遍历当前页面的资源
PDResources resources = page.getResources();
for (COSName name : resources.getXObjectNames()) {
    PDXObject xobj = resources.getXObject(name);
    if (xobj instanceof PDImageXObject) {
        PDImageXObject image = (PDImageXObject) xobj;
        try {
            image.getImage(); // 触发异常检测
        } catch (IllegalArgumentException e) {
            if (e.getMessage().contains("Numbers of source Raster bands and source color space components do not match")) {
                try (InputStream is = image.createInputStream()) {
                    BufferedImage img = ImageIO.read(is);
                    if (img != null) {
                        // 创建新的图片对象替换原异常图片
                        PDImageXObject newImage = PDImageXObject.createFromByteArray(document, ImageIOUtil.writeImageToBytes(img, "JPEG"), "fixed_image.jpg");
                        resources.putXObject(name, newImage);
                    }
                } catch (IOException ex) {
                    // 处理解码失败的情况，比如跳过该图片
                }
            }
        }
    }
}

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