如何排查javac无法加载-classpath有效路径下的PDFBox库问题？

问题详情 #

尝试使用Apache PDFBox 2.0.28库时，javac始终无法加载pdfbox-2.0.28.jar，执行以下任意命令：

javac -cp "pdfbox-2.0.28.jar" MyPdf.java
javac -cp ".:pdfbox-2.0.28.jar" MyPdf.java
javac -cp "pdfbox-2.0.28.jar:." MyPdf.java
javac -sourcepath "pdfbox-2.0.28.jar" MyPdf.java

都会抛出相同错误：

MyPdf.java:1: error: package org.apache.pdfbox does not exist
import org.apache.pdfbox.*;
^
1 error

已确认的信息：

• jar包未损坏，可正常解压，内部存在org/apache/pdfbox相关类文件
• 目录结构：

pdf
├── MyPdf.java
├── pdfbox-2.0.28.jar
└── sample.pdf

• 测试代码MyPdf.java：

import org.apache.pdfbox.*;

public class MyPdf {
    public static void main (String... args) {}
}

已查阅相关资料但未解决问题，需进一步排查错误原因。

排查步骤 #

• 验证Java版本兼容性：PDFBox 2.0.28要求Java 8及以上版本，执行java -version确认当前JDK版本是否符合，避免用低于Java 8的版本编译。
• 用绝对路径指定jar包：替换相对路径为绝对路径测试，比如javac -cp "/home/user/pdf/pdfbox-2.0.28.jar" MyPdf.java，排除相对路径解析错误的可能。
• 校验jar包内容准确性：执行jar tf pdfbox-2.0.28.jar | grep "org/apache/pdfbox/PDFBox.class"，确认jar包内确实存在核心类文件，避免解压预览和实际编译读取的内容不一致。
• 排查全局CLASSPATH干扰：执行echo $CLASSPATH，若输出非空，可能全局classpath覆盖了命令行指定路径，可临时清空后测试：CLASSPATH= javac -cp ".:pdfbox-2.0.28.jar" MyPdf.java。
• 用java命令验证jar可用性：执行java -cp pdfbox-2.0.28.jar org.apache.pdfbox.PDFBox，若jar包正常，会输出PDFBox帮助信息，确认JVM能正常识别该jar。
• 检查文件读权限：执行ls -l pdfbox-2.0.28.jar查看权限，若当前用户无读权限，执行chmod +r pdfbox-2.0.28.jar修改。
• 替换通配符导入为具体类：把import org.apache.pdfbox.*;改为import org.apache.pdfbox.pdmodel.PDDocument;这类具体类导入，再编译测试，排除通配符解析的潜在问题。

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