无法导入本地Spring Boot Kotlin项目Jar至Maven项目的问题排查

1. 确认公共项目的打包与构件完整性 #

• 检查公共项目pom.xml的打包方式，确保是jar（默认值，若误设为pom会导致无class文件）：

  <packaging>jar</packaging>
  

• 执行公共项目的mvn clean install，查看target目录下生成的jar包，确认内部包含Kotlin编译后的class文件，且目录结构与包名匹配。同时检查本地Maven仓库（~/.m2/repository）对应路径下是否存在完整的jar和pom文件。

2. 核对目标项目的依赖配置 #

• 确认目标项目pom中依赖的groupId、artifactId、version与公共项目完全一致，注意大小写、SNAPSHOT版本标识是否正确：

  <dependency>
      <groupId>公共项目groupId</groupId>
      <artifactId>公共项目artifactId</artifactId>
      <version>对应版本号</version>
  </dependency>
  

• 若公共项目是多模块结构，确保依赖的是包含业务代码的子模块，而非仅作为父pom的模块。

3. 检查公共类的可见性与包路径 #

• 确认公共项目中的类是public权限（Kotlin默认public，若显式声明internal则仅能在模块内访问）。
• 核对类的实际包路径与目标项目导入时的包名是否完全一致，避免拼写错误（比如截图中的类包名是com.example.common，导入时不能写成com.example.commons）。

4. 清理IntelliJ缓存并同步依赖 #

• 执行File -> Invalidate Caches... -> Invalidate and Restart，清理IDE缓存后重启，这是解决多数依赖识别问题的常用手段。
• 右键目标项目选择Maven -> Reload Project，强制重新同步Maven依赖。
• 进入Project Structure -> Modules，检查目标模块的Dependencies列表，确认公共项目的jar已正确引入且无红色警告。

5. 排查Maven编译与依赖传递问题 #

• 确认公共项目的Kotlin插件版本适配Java17（推荐使用1.8+版本），插件配置示例：

  <plugin>
      <groupId>org.jetbrains.kotlin</groupId>
      <artifactId>kotlin-maven-plugin</artifactId>
      <version>1.8.22</version>
      <executions>
          <execution>
              <id>compile</id>
              <goals>
                  <goal>compile</goal>
              </goals>
              <configuration>
                  <sourceDirs>
                      <sourceDir>${project.basedir}/src/main/kotlin</sourceDir>
                      <sourceDir>${project.basedir}/src/main/java</sourceDir>
                  </sourceDirs>
              </configuration>
          </execution>
      </executions>
  </plugin>
  

• 在目标项目根目录执行mvn dependency:tree，确认公共项目依赖已被正确引入，无冲突或被排除的情况。
• 执行mvn compile，查看控制台输出，排查是否存在编译错误、依赖缺失等问题。

6. 修复本地Maven仓库损坏构件 #

• 找到本地Maven仓库中公共项目的构件目录，删除后重新执行公共项目的mvn clean install，再同步目标项目依赖，避免构件损坏导致类无法识别。

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