Spring Boot自动装配spring-data Repository报No qualifying bean异常

报错核心是Spring容器初始化时找不到MyRepository类型的代理Bean，按以下顺序排查就能解决问题：

• 检查包扫描范围
  Spring Boot默认仅扫描主启动类所在包及其子包下的组件。如果MyRepository不在这个路径范围内，需要在启动类上添加对应数据模块的扫描注解：使用Spring Data JPA就添加@EnableJpaRepositories("你的Repository所在包全路径")，使用Spring Data JDBC就添加@EnableJdbcRepositories("你的Repository所在包全路径")，使用MongoDB等其他存储模块同理添加对应@EnableXxxRepositories注解指定扫描路径。
• 校验实体类@Id注解是否匹配当前使用的Spring Data模块
  你当前实体类引入的是org.springframework.data.annotation.Id：
  • 如果用的是Spring Data JDBC、Spring Data MongoDB等非JPA组件，这个注解是正确的
  • 如果用的是Spring Data JPA，这个注解导包错误，Spring Boot 3.x版本需要替换为jakarta.persistence.Id，Spring Boot 2.x版本需要替换为javax.persistence.Id。@Id注解不匹配会导致Spring无法识别实体类映射，进而不会生成对应的Repository代理Bean。
• 检查Kotlin代码声明是否符合Spring要求
  你当前写的Repository接口代码：

  interface MyRepository : CrudRepository<MyEntity, Long> {}
  

  语法本身没有问题，但要注意两个细节：
  1. 不要手动给Repository接口加internal、private可见性修饰符，必须保证接口是public可访问的（Kotlin顶层声明默认是public，没有手动加修饰符就不会有问题）
  2. 如果为Repository写了自定义实现类，实现类必须加@Repository注解，且类名要遵循接口名+Impl的默认命名规则，否则Spring无法识别装配。
• 确认依赖引入完整
  检查构建配置文件（pom.xml/build.gradle），确认已经引入了对应Spring Data模块的starter依赖：比如用JPA需要引入spring-boot-starter-data-jpa，用JDBC需要引入spring-boot-starter-data-jdbc，缺少对应starter时自动配置不会生效，自然不会生成Repository相关Bean。

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