使用iText 7试用版的Java应用导出Jar时的许可证附加问题

我来帮你搞定这个头疼的问题！你遇到的情况非常典型——在IDE里运行一切正常，打包成Jar就掉链子，核心原因是许可证文件的读取方式不兼容Jar包的资源结构：

在IntelliJ本地运行时，代码是直接从本地文件系统读取许可证文件的，路径能直接命中；但打包成Jar后，许可证文件是嵌入在Jar包内部的资源，不再是独立的文件系统路径，原来的读取方式自然失效了。

下面是具体的解决步骤：

• 第一步：调整许可证文件的存放位置
  把你的许可证文件（比如itextkey.json）放到项目的src/main/resources目录下（Maven/Gradle项目）；如果是普通Java项目，就放到src目录里。这样打包时，IDE会自动把这个文件包含到Jar包的根目录下。

• 第二步：修改读取许可证的代码
  放弃用File类或者绝对路径读取，改用类加载器的资源流读取方法。举个例子：
  原来的代码可能是这样的：

  LicenseKey.loadLicenseFile("itextkey.json");
  

  改成下面的写法（记得把YourMainClass换成你项目里的主类或者任意一个存在的类）：

  try (InputStream licenseStream = YourMainClass.class.getClassLoader().getResourceAsStream("itextkey.json")) {
      if (licenseStream == null) {
          throw new IOException("找不到许可证文件！请确认itextkey.json已放入resources目录并正确打包");
      }
      LicenseKey.loadLicenseStream(licenseStream);
  } catch (IOException e) {
      e.printStackTrace();
      // 这里可以添加加载失败后的处理逻辑，比如给用户提示
  }
  

  这个方法会从Jar包内部的资源中读取文件，不管是IDE运行还是Jar运行都能正常工作。

• 第三步：确认打包配置
  用IntelliJ导出Jar的时候，一定要检查配置：

  1. 打开File -> Project Structure -> Artifacts
  2. 选中你要导出的Jar配置，确保resources目录被添加到了Jar的输出内容里（如果没看到，手动添加一下）
  3. 重新导出Jar，这样许可证文件就会被正确打包进去了。

• 额外小提醒
  注意文件名的大小写！Windows系统不区分大小写，但Linux/macOS和Jar内部的资源是区分大小写的，比如itextkey.json和ItextKey.json是两个不同的文件，别在这里踩坑。

内容的提问来源于stack exchange，提问作者Michał Urban