PDFBox 1.8中路径含\调用PDDocument.load(file)报错，改用/正常

你遇到的是PDFBox 1.8版本在处理Windows路径时的兼容性问题，核心是手动拼接路径的分隔符处理不当，导致PDF解析逻辑误判了内容。下面是具体分析和解决方案：

问题根源 #

你手动用\\拼接Windows路径时，虽然Java本身支持这种转义后的分隔符，但PDFBox 1.8的文件加载逻辑对这类手动拼接的路径存在解析bug，它误把路径中的部分内容当成了PDF文件内部的指令，从而抛出Expected an integer type, actual='statement'的错误。而直接使用正斜杠/的路径能正常工作，是因为正斜杠是Java和PDFBox都能正确识别的跨平台路径分隔符。

解决方案 #

1. 使用File类自动构建路径（推荐） #

避免手动拼接字符串路径，利用File类的构造方法自动适配系统路径分隔符，既跨平台又不会出错：

// 构建下载目录路径
File downloadsDir = new File(System.getProperty("user.home"), "Downloads");
// 构建PDF文件路径
File pdfFile = new File(downloadsDir, "PDFStatement.pdf");

System.out.println("file: " + pdfFile);
PDDocument document = PDDocument.load(pdfFile);

// 后续读取文本的逻辑不变
PDFTextStripper pdfStripper = new PDFTextStripper();
String text = pdfStripper.getText(document);
System.out.println(text);
document.close();

2. 使用File.separator拼接路径 #

如果一定要手动拼接字符串，用File.separator代替硬编码的\\或/，它会根据当前系统自动选择正确的路径分隔符：

String userDir = System.getProperty("user.home") + File.separator + "Downloads";
String filePath = userDir + File.separator + "PDFStatement.pdf";
File file = new File(filePath);

// 后续逻辑同上

3. 直接转换为正斜杠路径（临时方案） #

如果仅在Windows环境下临时使用，也可以把系统路径中的反斜杠替换为正斜杠，保持和测试成功的路径格式一致：

String userDir = System.getProperty("user.home").replace("\\", "/") + "/Downloads";
String filePath = userDir + "/PDFStatement.pdf";
File file = new File(filePath);

补充说明 #

PDFBox 1.8是比较老旧的版本，这类路径解析的bug在后续3.x版本中已经被修复。如果条件允许，建议升级到最新稳定版的PDFBox，能获得更好的兼容性和安全性。

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