无法从IntelliJ构建的自定义Jar包中导入类的问题求助

问题场景 #

我将一个Jar包安装到本地.m2仓库后，在消费端项目的pom.xml中添加了以下依赖：

<dependency>
    <groupId>com.coussy</groupId>
    <artifactId>reusable</artifactId>
    <version>0.0.3-SNAPSHOT</version>
</dependency>

依赖能被IDEA识别，且提示可通过ALT + Enter导入类，但按下快捷键后始终无法完成导入；执行mvn compile命令时，报错cannot find symbol。

解决步骤 #

• 检查本地Jar包的有效性
  找到本地.m2仓库中对应路径（~/.m2/repository/com/coussy/reusable/0.0.3-SNAPSHOT/），解压Jar包确认：

  • 目标类是否确实存在于Jar包内
  • 类的全限定名（包名+类名）是否和你尝试导入的完全一致（注意包名拼写、类名大小写）
  • Jar包不是空包或未完成编译的产物

• 重新正确安装Jar包
  确保安装命令参数完全匹配，重新执行：

  mvn install:install-file -Dfile=你的Jar包绝对路径 -DgroupId=com.coussy -DartifactId=reusable -Dversion=0.0.3-SNAPSHOT -Dpackaging=jar
  

  如果Jar包附带源码或javadoc，可额外添加-Dsources=源码Jar路径和-Djavadoc=文档Jar路径，帮助IDEA正确关联类信息。

• 刷新Maven依赖并清理缓存

  1. 在IDEA中点击右侧Maven面板的「Reload All Maven Projects」按钮
  2. 执行Maven清理+强制更新命令后重新编译：

     mvn clean install -U
     

     -U参数会强制更新快照依赖，避免本地旧缓存干扰。

• 重置IDEA缓存与配置

  1. 打开IDEA设置（Windows/Linux：File > Settings；Mac：IntelliJ IDEA > Settings），进入「Build, Execution, Deployment > Build Tools > Maven」，确认本地仓库路径和Maven版本配置正确
  2. 执行「File > Invalidate Caches...」，选择「Invalidate and Restart」，清除IDEA缓存后重启

• 统一JDK编译版本
  确保消费端项目的JDK编译版本和Jar包编译时使用的版本一致，避免版本不兼容导致类无法识别，可在pom.xml中指定：

  <build>
      <plugins>
          <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-compiler-plugin</artifactId>
              <version>3.8.1</version>
              <configuration>
                  <source>1.8</source> <!-- 替换为Jar包编译用的JDK版本 -->
                  <target>1.8</target>
              </configuration>
          </plugin>
      </plugins>
  </build>
  

内容的提问来源于stack exchange，提问作者work-in-progress