Spring Boot带数据库的类库集成到主应用时，UserRepository Bean无法找到的问题排查

看起来你遇到的核心问题是Spring Data JPA的Repository Bean没有被正确初始化——单纯的@ComponentScan没法触发Spring Data JPA的代理生成逻辑，再加上你把自动配置放在了主应用而非类库中，导致类库的JPA相关Bean没被正确加载。下面一步步帮你解决：

一、问题根源拆解 #

你的UserRepository是Spring Data JPA的接口，它不是普通的@Component：Spring需要通过@EnableJpaRepositories注解来扫描指定包下的Repository接口，动态生成代理类作为Bean注入上下文。你之前只给主应用加了@ComponentScan("com.example.demolib")，但这只会扫描类库中的@Service、@Repository（普通类），不会处理JPA Repository接口。

另外，你把类库的自动配置类放在了主应用里，这不符合Spring Boot类库的设计规范——类库应该自己提供自动配置，主应用只需要引入依赖即可自动生效。

二、具体修复步骤 #

1. 给类库demo-lib添加自动配置 #

在demo-lib中创建自己的自动配置类，让类库自己管理JPA扫描和Bean注册：

package com.example.demolib.autoconfig;

import com.example.demolib.HelloWorldService;
import com.example.demolib.User;
import com.example.demolib.UserRepository;
import org.springframework.boot.autoconfigure.condition.ConditionalOnClass;
import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean;
import org.springframework.boot.autoconfigure.domain.EntityScan;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.config.EnableJpaRepositories;

@Configuration
// 只有当类路径中存在JPA相关类时才生效
@ConditionalOnClass({JpaRepository.class, User.class})
// 扫描类库中的JPA Repository接口
@EnableJpaRepositories(basePackages = "com.example.demolib")
// 扫描类库中的JPA实体类
@EntityScan(basePackages = "com.example.demolib")
public class DemoLibAutoConfiguration {

    // 自动注册HelloWorldService，且只在没有自定义Bean时生效
    @Bean
    @ConditionalOnMissingBean
    public HelloWorldService helloWorldService(UserRepository userRepository) {
        return new HelloWorldService(userRepository);
    }
}

然后在demo-lib的src/main/resources/META-INF/spring.factories中注册这个自动配置（如果没有这个文件就新建）：

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.example.demolib.autoconfig.DemoLibAutoConfiguration

2. 简化主应用的配置 #

主应用不需要手动加@ComponentScan，也不需要自己写配置类，删除这些冗余代码：

package com.artelys.timetreelibintegration;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class TimetreelibIntegrationApplication {

    public static void main(String[] args) {
        SpringApplication.run(TimetreelibIntegrationApplication.class, args);
    }
}

同时删除主应用中的HelloLibConfig类，因为类库的自动配置已经会处理HelloWorldService的Bean注册。

3. 修复主应用的控制器 #

你的HelloWorldController缺少@RestController注解，Spring不会把它识别为Web控制器，补上这个注解：

package com.artelys.timetreelibintegration.controller;

import com.example.demolib.HelloWorldService;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloWorldController {

    private final HelloWorldService helloWorldService;

    public HelloWorldController(HelloWorldService helloWorldService) {
        this.helloWorldService = helloWorldService;
    }

    @GetMapping("/hello")
    public String timetreelib() {
        return helloWorldService.getHelloMessage();
    }
}

4. 检查依赖与数据库配置 #

• 确保demo-lib的pom.xml中包含spring-boot-starter-data-jpa依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>

• 主应用的application.properties/application.yml中配置好数据库连接信息（比如H2、MySQL等），JPA需要数据源才能初始化Repository：

# 示例H2内存数据库配置
spring.datasource.url=jdbc:h2:mem:testdb
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=
spring.jpa.database-platform=org.hibernate.dialect.H2Dialect
spring.h2.console.enabled=true

三、为什么这样能解决问题？ #

1. 类库的自动配置通过@EnableJpaRepositories和@EntityScan，明确告诉Spring要扫描类库中的JPA Repository和实体类，生成对应的Bean；
2. 主应用引入类库依赖后，Spring Boot会自动读取类库spring.factories中的自动配置，不需要手动扫描包或写配置；
3. 去掉冗余的@ComponentScan，避免覆盖主应用默认的包扫描范围，保证主应用自身的Bean也能正常加载。

备注：内容来源于stack exchange，提问作者Víctor Cardozo