iText 7.2.0试用许可证无法正常加载问题咨询

1 校验许可证文件本身合规性 #

• 确认许可证为iText 7版本适配的PDF Office模块专属试用密钥，iText 5、旧版iText 7核心模块的许可证无法兼容PDF Office扩展功能，会出现静默加载失败的情况
• 确认许可证文件未被篡改、重命名，保持官方下发的原始.xml格式，不要手动修改文件内部内容
• 确认许可证仍在30天有效期内，过期试用许可证加载时无显性报错，但会被标记为未加载状态
• 确认试用许可证的绑定设备和当前运行环境一致，部分类型的试用许可证会绑定设备硬件信息，更换设备后无法正常加载
• 确认密钥文件路径无中文、特殊字符、空格，程序运行进程对该路径拥有可读权限，可先执行简单的文件存在性校验：

  File licenseFile = new File("你的密钥文件绝对路径");
  // 输出为true才代表路径可正常访问
  System.out.println(licenseFile.exists() && licenseFile.canRead());
  

2 校验依赖版本与调用逻辑 #

• 确认项目中引入的licensekey依赖版本，和iText 7核心包、PDF Office模块的版本完全一致，版本不匹配是静默加载失败的高频原因
• 确认LicenseKey.loadLicenseFile()方法的调用时机，必须在所有iText相关API调用之前执行，如果已经初始化过PDF操作对象再加载许可证，加载状态不会生效
• 不要多次调用loadLicenseFile方法，重复加载会触发内部校验异常，首次调用后可以主动校验加载结果：

  LicenseKey.loadLicenseFile("path/to/itext-license.xml");
  if (!LicenseKey.isLoaded()) {
      throw new RuntimeException("许可证加载失败，请校验上述排查项");
  }
  

3 排查运行环境冲突 #

• 检查项目是否存在多版本iText依赖冲突，可以用依赖管理工具排查重复依赖：Maven执行mvn dependency:tree命令，Gradle执行gradle dependencies命令，清理掉所有版本不匹配的iText相关jar包
• 如果是在Web容器、Spring Boot这类多类加载器环境下运行，确认LicenseKey类和许可证加载逻辑属于同一个类加载器，跨类加载器会导致许可证状态无法全局共享

4 替代加载方案 #

排除上述问题后仍加载失败，可以尝试将许可证文件放到项目类路径下，用流的方式加载规避路径问题：

try (InputStream licenseStream = this.getClass().getResourceAsStream("/itext-license.xml")) {
    LicenseKey.loadLicenseFile(licenseStream);
} catch (IOException e) {
    e.printStackTrace();
}

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