模块化JavaFX项目添加依赖遇阻：JetBrains注解及非模块化依赖问题

一、解决当前org.jetbrains.annotations模块找不到的问题 #

1. 验证Maven依赖是否正确拉取 #

先确认本地Maven仓库中org.jetbrains:annotations:24.0.1的jar包是否完整，且包含module-info.class：

• 找到本地仓库路径（通常是~/.m2/repository/org/jetbrains/annotations/24.0.1/），解压annotations-24.0.1.jar，检查根目录下是否存在module-info.class。
• 如果缺失，执行mvn clean install重新拉取依赖，或者在IDE中刷新Maven项目（比如IntelliJ点击Maven面板的刷新按钮）。

2. 修复IDE缓存与编译配置 #

你的requires org.jetbrains.annotations;声明是正确的，若仍报错，尝试以下操作：

• 清理IDE缓存：以IntelliJ为例，执行File -> Invalidate Caches... -> Invalidate and Restart，清除缓存后重新加载项目。
• 检查Maven编译插件配置：确保插件指定与JavaFX一致的Java版本（17），避免版本不兼容导致模块识别失败。示例配置：

  <build>
      <plugins>
          <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-compiler-plugin</artifactId>
              <version>3.11.0</version>
              <configuration>
                  <release>17</release>
              </configuration>
          </plugin>
      </plugins>
  </build>
  

3. 确认注解导入路径正确 #

代码中注解的导入必须对应JetBrains的包路径：

import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;

避免错误导入其他包下的同名注解。

二、如何处理无module-info.java的非模块化依赖 #

当依赖jar没有module-info.java时，JVM会将其视为自动模块，处理方式如下：

1. 确定自动模块名称 #

• 优先查看jar包的MANIFEST.MF文件中的Automatic-Module-Name属性，这是官方指定的模块名，可靠性最高。
• 如果没有该属性，模块名通常是jar文件名去掉版本号，将连字符替换为点。例如commons-lang3-3.12.0.jar的自动模块名是commons.lang3（部分库命名可能不同，建议查阅官方文档确认）。

2. 在module-info.java中声明依赖 #

直接在module-info.java中添加requires <自动模块名称>;即可，示例：

module DVDIndexer {
    // 其他依赖声明...
    requires commons.lang3;
}

3. 特殊情况的临时处理 #

如果自动模块无法被识别，可以在Maven编译/运行插件中添加--add-modules参数强制引入，示例：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
        <release>17</release>
        <compilerArgs>
            <arg>--add-modules</arg>
            <arg>commons.lang3</arg>
        </compilerArgs>
    </configuration>
</plugin>

注意：这种方式仅作为临时方案，优先推荐在module-info.java中声明依赖。

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