SpringBoot引入外部自定义库时遇Repository Bean定义缺失异常求助

问题根源 #

Spring Boot 默认仅扫描主项目（Project A）启动类所在包及其子包内的组件、Repository等。当Project B作为依赖引入时，Project A的Spring上下文不会自动识别Project B中的JPA Repository，导致NoSuchBeanDefinitionException。

分步解决方案 #

1. 重构Project B的配置（移除独立启动类） #

作为依赖库，Project B不需要@SpringBootApplication标注的启动类（该注解用于独立应用启动），改用配置类统一管理组件和JPA配置：

@Configuration
// 扫描Project B下的所有组件（Service等）
@ComponentScan(basePackages = "com.yourprojectb")
// 扫描Project B下的JPA Repository接口
@EnableJpaRepositories(basePackages = "com.yourprojectb.repository")
// 若Project B包含实体类，需扫描实体包
@EntityScan(basePackages = "com.yourprojectb.entity")
public class ProjectBConfiguration {
}

2. 在Project A中引入Project B的配置 #

在Project A的启动类上，通过@Import显式加载Project B的配置类，确保Spring上下文初始化时包含Project B的Bean：

@SpringBootApplication
@Import(ProjectBConfiguration.class)
public class ProjectAApplication {
    public static void main(String[] args) {
        SpringApplication.run(ProjectAApplication.class, args);
    }
}

3. 确认Maven依赖有效性 #

• 先在Project B根目录执行mvn clean install，将库安装到本地Maven仓库
• 检查Project A的pom.xml依赖配置是否正确：

<dependency>
    <groupId>你的ProjectB groupId</groupId>
    <artifactId>project-b</artifactId>
    <version>1.0.0</version>
</dependency>

4. 替代方案：直接扩大Project A的扫描范围 #

若不愿修改Project B，可直接在Project A启动类中扩展扫描范围，覆盖Project B的包路径：

@SpringBootApplication(
    scanBasePackages = {"com.yourprojecta", "com.yourprojectb"}
)
@EnableJpaRepositories(basePackages = {"com.yourprojecta.repository", "com.yourprojectb.repository"})
@EntityScan(basePackages = {"com.yourprojecta.entity", "com.yourprojectb.entity"})
public class ProjectAApplication {
    public static void main(String[] args) {
        SpringApplication.run(ProjectAApplication.class, args);
    }
}

避坑提示 #

• 仅给Project B启动类加@ComponentScan无效：Project A的Spring上下文不会自动加载依赖库中的@SpringBootApplication类，必须显式引入或扩大扫描范围。
• 手动注册CoffeeOrdersService没用：Service依赖的CoffeeOrderRepository未被实例化，所以必须先确保Repository被Spring扫描并注册。

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