如何排查Maven依赖类找不到问题：SpringBoot库无法引用

这种情况我碰到过好多次，大概率是SpringBoot默认打包方式的“坑”，给你一步步梳理排查方向：

1. 先确认SpringBoot的打包类型是否正确 #

SpringBoot默认的spring-boot-maven-plugin会把项目打包成可执行的fat jar，这种jar里的业务类都藏在BOOT-INF/classes目录下，普通Maven项目依赖时根本读不到这个路径里的类——这是最常见的原因！

解决方法分两种，看你的需求选择：

• 方式一：保留SpringBoot可执行能力，同时生成可被依赖的普通jar
  修改你的SpringBoot项目pom.xml，给打包插件加个classifier配置：

  <build>
      <plugins>
          <plugin>
              <groupId>org.springframework.boot</groupId>
              <artifactId>spring-boot-maven-plugin</artifactId>
              <configuration>
                  <!-- 生成带lib后缀的普通jar，比如xxx.jar是可执行包，xxx-lib.jar是供依赖的库 -->
                  <classifier>lib</classifier>
              </configuration>
          </plugin>
      </plugins>
  </build>
  

  打包后用xxx-lib.jar去执行mvn install:install-file。

• 方式二：如果你的项目只是纯库（不需要独立运行），直接改用普通Maven打包
  移除SpringBoot的打包插件，保留基础的编译插件即可：

  <build>
      <plugins>
          <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-compiler-plugin</artifactId>
              <version>3.8.1</version>
              <configuration>
                  <source>1.8</source> <!-- 根据你的JDK版本调整 -->
                  <target>1.8</target>
              </configuration>
          </plugin>
      </plugins>
  </build>
  

2. 检查Maven依赖坐标是否完全匹配 #

在引用库的项目里，确保依赖的groupId、artifactId、version和你install到本地仓库的jar坐标完全一致（Maven对坐标大小写敏感，别写错）。

比如你install时指定了这些参数：

mvn install:install-file -Dfile=myPackage-lib.jar -DgroupId=com.yourteam -DartifactId=my-common-lib -Dversion=1.0.0 -Dpackaging=jar

那引用项目的pom里必须对应写：

<dependency>
    <groupId>com.yourteam</groupId>
    <artifactId>my-common-lib</artifactId>
    <version>1.0.0</version>
</dependency>

3. 清理Maven缓存并重新导入依赖 #

有时候Maven会缓存旧的依赖信息，明明本地仓库有jar，项目却“视而不见”。可以做这些操作：

• 在引用项目里执行mvn clean install -U，-U参数强制刷新依赖缓存
• 如果用IDE（比如IDEA），右键pom.xml → Maven → Reload Project，重新导入依赖
• 极端情况可以手动删除本地仓库中该依赖的目录，再重新执行mvn install:install-file

4. 验证打包的jar内容是否正确 #

解压你install的myPackage.jar，检查两个点：

• 业务类是不是直接在jar根目录下，而不是躲在BOOT-INF/classes里
• 最好在install时指定自己的pom文件：mvn install:install-file -Dfile=myPackage.jar -DpomFile=pom.xml，避免Maven生成默认pom导致依赖缺失（虽然一般不影响类引用，但更稳妥）

5. 检查依赖的Scope是否正确 #

确保引用项目里的依赖没有设置scope=provided或scope=test，这些scope会让编译时无法读取类。默认的scope=compile才是正确的。

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