使用PDFBOX打印含JPEG2000图片的PDF时JAI类库加载失败求助

错误原因 #

当使用java -jar命令启动程序时，-cp参数指定的类路径会被JVM忽略，程序只会使用目标Jar包（这里是pdfbox-app-2.0.29.jar）的META-INF/MANIFEST.MF文件中定义的类路径。你添加的JAI相关Jar包没有被纳入实际运行的类路径，所以PDFBox依然检测不到它们。

正确的启动命令 #

方法一：直接指定主类并配置完整类路径 #

放弃-jar参数，手动指定PDFBox的PrintPDF工具主类，同时把所有需要的Jar包都加入类路径：

Linux/macOS系统：

java -cp "./pdfbox-app-2.0.29.jar:./jai-*.jar" org.apache.pdfbox.tools.PrintPDF jpeg2000.pdf

Windows系统（路径分隔符用;）：

java -cp ".\pdfbox-app-2.0.29.jar;.\jai-*.jar" org.apache.pdfbox.tools.PrintPDF jpeg2000.pdf

方法二：修改PDFBox的MANIFEST.MF文件 #

编辑pdfbox-app-2.0.29.jar中的META-INF/MANIFEST.MF文件，找到Class-Path条目，将JAI的Jar包追加到后面：

Class-Path: ...(原有内容) jai-imageio-core-1.4.0.jar jai-imageio-jpeg2000-1.4.0.jar

保存后，就可以用你原来的-jar命令启动，JVM会自动加载追加的Jar包。

验证JAI包是否正常可用 #

如果担心JAI包本身有问题，可以编写一个简单的测试类，检查JPEG2000的ImageReader是否能被加载：

import javax.imageio.ImageIO;
import javax.imageio.spi.IIORegistry;
import javax.imageio.spi.ImageReaderSpi;

public class CheckJaiJpeg2000 {
    public static void main(String[] args) {
        IIORegistry registry = IIORegistry.getDefaultInstance();
        boolean found = false;
        for (ImageReaderSpi spi : registry.getServiceProviders(ImageReaderSpi.class, true)) {
            for (String format : spi.getFormatNames()) {
                if ("JPEG2000".equalsIgnoreCase(format)) {
                    System.out.println("找到JPEG2000 ImageReader: " + spi.getClassName());
                    found = true;
                }
            }
        }
        if (!found) {
            System.out.println("未找到JPEG2000 ImageReader");
        }
    }
}

编译并运行（确保类路径包含JAI的Jar包）：

javac CheckJaiJpeg2000.java
java -cp "./jai-*.jar:." CheckJaiJpeg2000

如果输出找到阅读器的信息，说明JAI包本身是正常的，问题出在PDFBox的启动类路径配置上。

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