Java 17项目模块化遇第三方JAR无效模块名警告，是否受阻？

警告的影响 #

这些警告不会直接阻碍模块化编译或运行，本质是JDK模块系统对未模块化JAR（自动模块）的提示：当JAR文件名包含非Java标识符（比如_2.13里的数字开头段）时，无法自动生成合规的模块名（Java模块名的每个段必须是合法标识符，不能以数字开头）。但项目的模块化代码依然可以正常编译、运行，只是构建日志会出现冗余警告。

可行的解决办法 #

1. 手动指定自动模块名（编译/运行时） #

在Maven编译或运行配置中，手动为这些问题JAR指定合法模块名，避免自动生成错误。比如在maven-compiler-plugin中添加编译参数：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-compiler-plugin</artifactId>
  <version>3.10.1</version>
  <configuration>
    <release>17</release>
    <compilerArgs>
      <!-- 为kafka测试JAR指定模块名 -->
      <arg>--add-modules org.apache.kafka.test</arg>
      <arg>--module-path ${project.build.dependencyClasspath}</arg>
      <!-- 为jackson-scala模块指定模块名 -->
      <arg>--add-modules com.fasterxml.jackson.module.scala</arg>
    </compilerArgs>
  </configuration>
</plugin>

这种方式无需修改依赖本身，只是在构建时强制指定模块名，消除警告。

2. 使用Moditect插件为依赖添加模块信息（长期方案） #

Moditect是专门用于Java模块化改造的Maven插件，可以给未模块化的JAR添加合法的module-info.class，从根源解决警告问题。在POM中配置插件，针对问题依赖生成合规模块信息：

<plugin>
  <groupId>org.moditect</groupId>
  <artifactId>moditect-maven-plugin</artifactId>
  <version>1.0.0.Final</version>
  <executions>
    <execution>
      <id>fix-dependency-modules</id>
      <phase>process-resources</phase>
      <goals>
        <goal>add-module-info</goal>
      </goals>
      <configuration>
        <modules>
          <!-- 处理kafka_2.13-test.jar -->
          <module>
            <artifact>
              <groupId>org.apache.kafka</groupId>
              <artifactId>kafka_2.13</artifactId>
              <version>3.1.2</version>
              <classifier>test</classifier>
            </artifact>
            <moduleInfo>
              <name>org.apache.kafka.test</name>
              <exports>org.apache.kafka.common</exports>
              <exports>org.apache.kafka.clients</exports>
              <!-- 根据项目实际依赖的包添加exports/opens -->
            </moduleInfo>
          </module>
          <!-- 处理jackson-module-scala_2.13.jar -->
          <module>
            <artifact>
              <groupId>com.fasterxml.jackson.module</groupId>
              <artifactId>jackson-module-scala_2.13</artifactId>
              <version>2.13.5</version>
            </artifact>
            <moduleInfo>
              <name>com.fasterxml.jackson.module.scala</name>
              <exports>com.fasterxml.jackson.module.scala</exports>
              <requires transitive>com.fasterxml.jackson.databind</requires>
            </moduleInfo>
          </module>
        </modules>
      </configuration>
    </execution>
  </executions>
</plugin>

插件会在构建过程中修改依赖JAR，添加合法的模块声明，后续构建就不会再出现警告。

3. 临时忽略警告 #

如果暂时不想处理依赖模块名，可以在编译插件中抑制特定警告：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-compiler-plugin</artifactId>
  <version>3.10.1</version>
  <configuration>
    <release>17</release>
    <compilerArgs>
      <!-- 关闭无效模块名警告 -->
      <arg>-Xlint:-invalid-module-name</arg>
    </compilerArgs>
  </configuration>
</plugin>

这是临时方案，适合快速推进模块化改造，但长期建议采用前两种方法，避免后续模块化扩展时出现潜在问题。

内容的提问来源于stack exchange，提问作者Marc Le Bihan