JavaFX项目中Itext7模块依赖警告与解析错误的解决方法

问题根源 #

你的问题出在iText 7.1.18版本的kernel模块尚未适配JPMS（Java平台模块系统）：

• 它属于自动模块，模块名从jar文件名（kernel-7.1.18.jar）推导为kernel，因此编译器会提示“模块名不稳定”的警告；
• 你尝试使用的com.itextpdf.kernel是该模块在后续JPMS兼容版本中的正式模块名，7.1.18版本没有这个模块定义，所以报错无法解析。

解决方案 #

方案1：保留7.1.18版本，抑制警告

如果不需要升级，可通过两种方式消除警告：

• 局部抑制：在你的module-info.java顶部添加注解：

  @SuppressWarnings("module")
  module your.module.name {
      requires transitive kernel;
  }
  

• 全局抑制：通过Maven编译插件忽略该类警告，在pom.xml的build节点下添加：

  <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <version>3.8.1</version>
      <configuration>
          <compilerArgs>
              <arg>-Xlint:-module</arg>
          </compilerArgs>
      </configuration>
  </plugin>
  

方案2：升级到JPMS兼容版本（推荐）

iText7从7.2.0版本开始全面支持JPMS，所有核心模块都带有正式的module-info.java，模块名统一为com.itextpdf.*格式：

1. 升级pom依赖：

   <dependency>
       <groupId>com.itextpdf</groupId>
       <artifactId>itext7-core</artifactId>
       <version>7.2.0</version>
       <type>pom</type>
   </dependency>
   

2. 修改module-info.java为正式模块名：

   requires transitive com.itextpdf.kernel;
   

   这样既无警告也无错误，同时获得稳定的模块依赖定义。

方案3：直接使用自动模块名（不推荐）

如果你坚持用7.1.18版本，也可以保留requires transitive kernel;——警告只是提示模块名可能在后续版本变更，不影响当前代码的编译与运行。

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