Spring Boot项目无法识别自定义Starter中的Bean问题求助

核心原因 #

Spring Boot无法自动识别Starter中的UserRepository并创建Bean，通常是因为Starter缺少必要的自动配置逻辑，导致主项目的组件扫描无法覆盖到Starter的包路径。

具体解决步骤 #

1. 在Starter中添加自动配置类 #

在Starter项目里创建一个自动配置类，通过@EnableJpaRepositories指定Repository所在包，同时用@EntityScan指定实体类的包路径：

package com.example.demostarter.config;

import org.springframework.boot.autoconfigure.domain.EntityScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.jpa.repository.config.EnableJpaRepositories;

@Configuration
@EnableJpaRepositories(basePackages = "com.example.demostarter.repository")
@EntityScan(basePackages = "com.example.demostarter.entity")
public class DemoStarterAutoConfiguration {
}

2. 配置Starter的自动配置入口 #

在Starter的src/main/resources/META-INF目录下创建spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件，内容为自动配置类的全限定名：

com.example.demostarter.config.DemoStarterAutoConfiguration

Spring Boot启动时会自动加载这个配置类，从而扫描到Starter里的Repository和实体类。

3. 确认Repository注解规范 #

确保Starter中的UserRepository正确继承Spring Data JPA的JpaRepository（无需额外加@Repository，Spring会自动为其创建代理Bean）：

package com.example.demostarter.repository;

import com.example.demostarter.entity.User;
import org.springframework.data.jpa.repository.JpaRepository;

public interface UserRepository extends JpaRepository<User, Long> {
}

4. 检查主项目依赖配置 #

确认主项目的pom.xml（或build.gradle）已正确引入Starter依赖，且版本匹配：

<!-- Maven示例 -->
<dependency>
    <groupId>com.example</groupId>
    <artifactId>demostarter</artifactId>
    <version>1.0.0</version>
</dependency>

验证 #

完成上述配置后，重新构建Starter并更新主项目依赖，启动主项目即可解决Bean找不到的问题。

内容的提问来源于stack exchange，提问作者Ali BOUKHTA -CROIX-