使用iText 5在Liberty服务器填充PDF遇“PDF not found”问题求助

看起来你遇到的问题很典型——本地测试完全正常，一部署到Liberty服务器就找不到PDF模板，而且明明确认路径是对的（故意写错路径还会报不同错误）。这大概率是服务器环境和本地环境的资源加载机制差异导致的，毕竟本地是直接访问文件系统，而Liberty里的WEB应用资源是打包在WAR包中的，不能用常规的文件路径方式访问。下面给你几个针对性的解决方案：

1. 改用类加载器加载PDF模板（核心解决方案） #

本地测试时你可能用的是文件系统路径，比如：

PdfReader reader = new PdfReader("template.pdf");

但在Liberty服务器中，WAR包内的资源无法通过文件系统路径直接访问，必须通过类加载器获取输入流。修改代码为：

// 假设PDF模板放在src/main/resources/templates目录下（Maven项目）
InputStream templateStream = getClass().getResourceAsStream("/templates/template.pdf");
if (templateStream == null) {
    throw new RuntimeException("PDF模板未找到，请检查资源路径");
}
PdfReader reader = new PdfReader(templateStream);

注意：

• 路径开头的/代表类路径的根目录（对应WAR包中的WEB-INF/classes目录）
• 如果是在静态方法中，要用YourClassName.class.getResourceAsStream(...)替代getClass()

2. 确认PDF模板已被正确打包到WAR中 #

有时候问题出在打包环节——模板文件没被包含到WAR包里。你可以：

• 解压生成的WAR包，检查WEB-INF/classes/templates（对应Maven的src/main/resources/templates）下是否存在你的PDF模板
• 如果是Maven项目，确保src/main/resources目录下的文件会被自动打包到WEB-INF/classes（默认是这样，但如果有自定义打包配置可能会影响）

3. 排查Liberty的类加载配置 #

如果你的应用依赖了共享库，或者在server.xml中配置了自定义类加载器，可能会导致应用类加载器无法找到资源：

• 检查server.xml中的<classloader>配置，比如是否设置了commonLibraryRef，导致资源被加载到共享类加载器中，而应用类加载器无法访问
• 可以尝试移除自定义类加载配置，或者确保PDF模板所在的资源目录在应用的类加载路径范围内

4. 添加调试日志定位问题 #

在代码中打印资源的URL，帮助你确认资源是否真的被找到：

URL resourceUrl = getClass().getResource("/templates/template.pdf");
System.out.println("PDF模板资源URL：" + resourceUrl);

如果输出是null，说明资源确实没被类加载器找到，需要检查路径和打包情况；如果输出类似war:file:/path/to/your/app.war!/WEB-INF/classes/templates/template.pdf，说明资源找到了，那可能是iText的读取逻辑有问题（但你本地测试正常，这种情况概率很低）

为什么本地测试没问题？ #

本地运行Java应用时，类路径直接指向target/classes目录，你可以用文件路径或者类加载器方式访问资源；但部署到Liberty后，资源被打包到WAR包内，文件系统路径无法直接访问WAR内部的文件，必须通过类加载器的输入流方式读取。

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