Spring Boot自定义starter中JPA Repository自动注入失败如何解决？

问题根源分析 #

1. Repository扫描方式错误：你用@ComponentScan扫描com.closure.table，但Spring Data JPA的Repository是动态代理生成的，必须用@EnableJpaRepositories（对应MongoDB等其他持久化框架需用对应注解）扫描Repository接口，普通@ComponentScan无法识别并创建Repository bean。
2. @DependsOn配置错误：@DependsOn("CategoryTypeRepository")中的bean名称不符合Spring默认规则，Spring Data生成的Repository bean默认是类名首字母小写，应该是categoryTypeRepository。
3. 自动配置顺序问题：@AutoConfigureAfter(SpringDataWebAutoConfiguration.class)仅保证在SpringDataWebAutoConfiguration之后执行，但Spring Data Repository的初始化由专门的配置类负责，需要确保Repository完全初始化后再创建依赖它的Service。

具体解决方案 #

方案一：修正自动配置类的Repository扫描与依赖配置 #

在ClosureTableAutoConfiguration上添加Repository扫描注解，并修正@DependsOn的bean名称：

@Configuration
@AutoConfigureAfter(JpaRepositoriesAutoConfiguration.class)
@ComponentScan(basePackages = {"com.closure.table"})
@EnableJpaRepositories(basePackages = {"com.closure.table.repository"}) // 新增Repository扫描
public class ClosureTableAutoConfiguration {

    private final CategoryTypeRepository categoryTypeRepository;

    // 构造函数注入（建议用final保证不可变）
    public ClosureTableAutoConfiguration(CategoryTypeRepository categoryTypeRepository){
        this.categoryTypeRepository = categoryTypeRepository;
    }

    @Bean
    @ConditionalOnMissingBean
    public ClosureTable closureTable() {
        return new ClosureTable();
    }

    @Bean
    @ConditionalOnMissingBean
    @DependsOn("categoryTypeRepository") // 修正为小写开头的bean名称
    public CategoryTypeService getCategoryTypeService() {
        return new CategoryTypeService(categoryTypeRepository);
    }
    // ...
}

方案二：正确注册Starter的自动配置类 #

自定义Starter必须在src/main/resources/META-INF/spring.factories中注册自动配置类，让Spring Boot自动发现它，无需业务项目手动@Import：

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.closure.table.ClosureTableAutoConfiguration

完成后，业务项目只需引入Starter依赖即可，无需再创建ClosureTableConfiguration类。

额外检查项 #

• 确保CategoryTypeRepository接口上添加@Repository注解（规范且避免扫描遗漏）：

@Repository
public interface CategoryTypeRepository extends JpaRepository<CategoryType, Long> {
    // ...
}

• 验证业务项目的配置文件（application.properties/yaml）中，数据源、JPA相关参数配置正确，确保Spring Data能正常初始化Repository。

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