Spring微服务启动报错：RegistrationRepository Bean未找到

核心问题分析 #

报错RegistrationService构造器参数0需要RegistrationRepository类型的Bean但未找到，说明Spring容器无法识别并加载你的RegistrationRepository Bean，即便添加了@Repository注解，常见诱因及解决方式如下：

• 包扫描范围未覆盖Repository类
  Spring默认仅扫描启动类所在包及其子包，若RegistrationRepository的包路径不在该范围内，即便加了@Repository也不会被扫描到。可通过在启动类添加@ComponentScan指定额外扫描路径，或调整Repository的包结构与启动类保持层级一致。

• Repository未继承Spring Data基础接口
  若使用Spring Data实现Repository，必须让接口继承JpaRepository/CrudRepository等Spring Data提供的基础接口，否则Spring无法自动生成代理Bean。示例：

  // 正确写法
  public interface RegistrationRepository extends JpaRepository<Registration, Long> {
      // 自定义业务方法
  }
  

• 多模块依赖配置缺失
  若RegistrationRepository位于独立模块，需确认注册模块的pom.xml/build.gradle中已正确引入该模块依赖，且依赖scope设置为compile（或对应Gradle配置），避免因依赖缺失导致类无法加载。

• 注解使用错误
  确认@Repository注解是org.springframework.stereotype.Repository，而非其他框架的同名注解。同时检查RegistrationService是否添加了@Service/@Component注解，确保Spring能扫描到Service类并触发依赖注入。

• 启动类缺失必要注解
  若使用Spring Data JPA，启动类需添加@EnableJpaRepositories注解并指定Repository所在包路径，示例：

  @SpringBootApplication
  @EnableJpaRepositories(basePackages = "com.yourproject.repository")
  public class RegistrationApplication {
      public static void main(String[] args) {
          SpringApplication.run(RegistrationApplication.class, args);
      }
  }
  

快速验证步骤 #

1. 核对RegistrationRepository的包路径是否在启动类默认扫描范围内，或是否通过@ComponentScan/@EnableJpaRepositories指定了该路径。
2. 确认Repository接口继承了Spring Data的基础接口。
3. 检查所有注解的全类名，避免引入错误框架的注解。
4. 验证模块间依赖配置，确保Repository所在模块被注册模块正确引入。

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