Spring从依赖JAR加载Services和Repositories启动报错排查

我来帮你拆解下这个问题，你遇到的NoClassDefFoundError本质是Web项目找不到公共JAR里的类，大概率是依赖引入或组件扫描配置的问题，咱们一步步来解决：

1. 先确认本地Maven依赖是否真的生效 #

首先得排除最基础的问题——你的公共JAR有没有被Web项目正确拉取到：

• 打开Web项目的pom.xml，检查依赖公共JAR的配置，确保groupId、artifactId、version和公共项目完全一致，比如：

  <dependency>
      <groupId>com.mdenis</groupId>
      <artifactId>mdhis_common</artifactId>
      <version>1.0.0</version>
  </dependency>
  

• 去本地Maven仓库（默认是~/.m2/repository/com/mdenis/mdhis_common/）里找到对应的JAR包，解压后看看有没有com/mdenis/mdhis_common/service/UserService.class这个文件，如果没有说明公共项目打包有问题，得先执行mvn clean install把公共项目安装到本地仓库。

2. 修正@ComponentScan，同时扫描新旧包 #

你现在只配置了扫描公共包，但Web项目自己的旧包（com.mdenis.mdhis_webclient）里的组件也需要被扫描，而且要确保公共包的组件也被正确识别：

• 正确的多包扫描写法是传递一个数组给basePackages：

  @ComponentScan(basePackages = {"com.mdenis.mdhis_webclient", "com.mdenis.mdhis_common"})
  

• 更推荐的方式是用basePackageClasses，避免硬编码包名（只要传入两个包下的任意类即可）：

  // 假设WebClientApplication是你Web项目的启动类，CommonApplication是公共项目的配置类
  @ComponentScan(basePackageClasses = {WebClientApplication.class, CommonApplication.class})
  

  这样哪怕后续包名改了，代码也不用跟着改。

3. 检查公共项目的打包配置 #

如果公共JAR里确实有UserService类，但Web项目还是找不到，得确认公共项目的打包是否正确：

• 公共项目的pom.xml里要指定<packaging>jar</packaging>（默认就是jar，但最好显式声明）
• 确保公共项目里的@Service、@Repository等注解的类都被正确编译，执行mvn clean package后再检查JAR内容。

4. 清理缓存，重新构建 #

有时候IDE或Maven的缓存会导致奇怪的问题：

• 先执行Web项目的mvn clean install，彻底清理旧的构建文件
• 如果是用IntelliJ/Eclipse，清理IDE缓存（IntelliJ是File -> Invalidate Caches...），然后重启IDE重新加载项目

额外注意点 #

• 如果公共项目里有Hibernate实体类，还要在Web项目里配置@EntityScan来扫描这些实体包，比如：

  @EntityScan(basePackages = {"com.mdenis.mdhis_webclient.entity", "com.mdenis.mdhis_common.entity"})
  

• 检查公共项目和Web项目的Spring、Hibernate版本是否一致，版本冲突也可能导致类加载失败。

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