PDFBox添加JPEG图片报IllegalArgumentException：如何修复？

你的问题核心是误用了PDImageXObject.createFromFile方法——这个方法要求传入本地文件路径，而你直接传了Base64编码字符串，导致PDFBox无法正确解析图片类型，JPEG触发了明确的不支持异常，PNG能正常工作属于巧合（比如测试用PNG的Base64字符串刚好匹配了某个本地文件路径，或者其他偶发情况）。

修复方案 #

把Base64字符串解码为字节数组，改用PDImageXObject.createFromByteArray方法加载图片，这个方法支持直接从字节流创建图片对象，兼容JPEG和PNG格式。

修改后的核心代码如下：

// 新增Base64解码工具方法
private byte[] decodeBase64(String base64Str) {
    // 移除可能存在的Base64前缀（如"data:image/jpeg;base64,"）
    if (base64Str.startsWith("data:image/")) {
        base64Str = base64Str.split(",")[1];
    }
    return Base64.getDecoder().decode(base64Str);
}

// 替换原有的页眉图片加载逻辑
if(pt.getExternal_file_header_add() !=null && pt.getExternal_file_header_add()){
    if(headerLogo !=null && !"".equals(headerLogo)){
        try {
            byte[] headerImageBytes = decodeBase64(headerLogo);
            PDImageXObject headerImage = PDImageXObject.createFromByteArray(doc, headerImageBytes, "header logo");
            contents.drawImage(headerImage, pt.getHeader_x_positionEx(), pt.getHeader_y_positionEx());
        } catch (Exception e) {
            // 处理图片解码或加载失败的情况
            e.printStackTrace();
        }
    }
}

// 页脚部分同理修改
if(pt.getExternal_file_footer_add() !=null && pt.getExternal_file_footer_add()){
    if(footerLogo !=null && !"".equals(footerLogo)){
        try {
            byte[] footerImageBytes = decodeBase64(footerLogo);
            PDImageXObject footerImage = PDImageXObject.createFromByteArray(doc, footerImageBytes, "footer logo");
            contents.drawImage(footerImage, pt.getFooter_x_positionEx(), pt.getFooter_y_positionEx());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

关键说明 #

• 如果你的Base64字符串没有前缀（直接是纯编码内容），可以去掉decodeBase64方法里的前缀判断逻辑。
• createFromByteArray会自动识别JPEG/PNG等PDFBox支持的图片类型，无需手动指定格式。
• 添加异常捕获可以避免单个图片加载失败导致整个PDF处理流程中断。

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