Java17 Maven项目导入Java8本地Jar包提示包不存在

我需要将基于Java 1.8构建的本地Jar包SPK-1.0.jar导入使用Java 17的Maven项目，采用maven-install-plugin配置后，父POM和模块POM的配置如下：

父POM配置 #

<plugin>
    <artifactId>maven-install-plugin</artifactId>
    <executions>
        <execution>
            <id>local-spk-sdk</id>
            <phase>clean</phase>
            <goals>
                <goal>install-file</goal>
            </goals>
            <configuration>
                <file>${project.main.basedir}/lib/SPK-1.0.jar</file>
                <groupId>com.org.services.spkservice</groupId>
                <artifactId>SPKClient</artifactId>
                <version>1.0</version>
                <packaging>jar</packaging>
            </configuration>
        </execution>
    </executions>
</plugin>

模块POM依赖配置 #

<dependency>
    <groupId>com.org.services.spkservice</groupId>
    <artifactId>SPKClient</artifactId>
    <version>1.0</version>
</dependency>

已确认本地M2仓库路径下~/.m2/repository/com/org/services/spkservice目录存在该Jar包，但在Java文件中导入对应类时，出现错误：

package com.org.services.spkservice does not exist 

可能的解决环节 #

• 检查Jar包内实际包结构
  直接解压SPK-1.0.jar，查看内部类的实际包路径是否与POM中配置的groupId匹配。比如Jar内的类可能属于com.spk.core而非com.org.services.spkservice，这种情况下POM配置的groupId错误，会导致代码导入包找不到。

• 调整插件执行阶段
  当前插件绑定的是clean阶段，仅执行mvn clean时才会安装Jar。建议将阶段改为initialize或process-resources，确保Maven构建初期就完成Jar安装：

  <phase>initialize</phase>
  

  修改后执行mvn clean install重新构建项目。

• 手动刷新IDE Maven依赖
  部分IDE不会自动同步Maven配置，打开IDE的Maven面板（如IntelliJ的Maven侧边栏），点击「Reload All Maven Projects」，确认模块依赖列表中存在SPKClient。

• 配置Java版本兼容性
  由于Jar基于Java 8构建，项目使用Java 17，需确保Maven编译配置兼容旧版本字节码。在父POM或模块POM中添加maven-compiler-plugin配置：

  <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <version>3.11.0</version>
      <configuration>
          <source>17</source>
          <target>17</target>
          <release>17</release>
          <compilerArgs>
              <arg>--add-modules=ALL-SYSTEM</arg>
          </compilerArgs>
          <encoding>UTF-8</encoding>
      </configuration>
  </plugin>
  

• 重新安装Jar到M2仓库
  可能存在Jar安装不完整或损坏的情况，删除M2仓库中com/org/services/spkservice目录，重新执行mvn install命令，确保Jar被正确安装。

• 清除IDE缓存
  IDE缓存可能导致依赖识别异常，比如IntelliJ可通过「File -> Invalidate Caches... -> Invalidate and Restart」清除缓存后重新导入项目。

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