Spring Boot测试报错：No qualifying bean of type Repository问题求助

我来帮你梳理下这个问题的常见解决思路——既然你的主应用运行正常，那问题大概率出在测试上下文的Bean扫描配置上，毕竟运行时能找到Repository，说明Bean定义本身是没问题的。下面是几个你可以逐一排查的方向：

1. 检查测试上下文的组件扫描范围是否覆盖commons模块 #

Spring Boot默认的组件扫描是从主应用类（这里是ApigatewayApplication）所在的包开始，只扫描当前包及其子包。如果你的commons模块的Repository在另一个独立的包下（比如com.yourcompany.commons.repository），而ApigatewayApplication在com.yourcompany.apigateway，那测试上下文可能没扫描到commons的Repository。

解决方法：

• 在主应用类ApigatewayApplication上显式指定扫描包，把commons的包加进去：

  @SpringBootApplication
  @ComponentScan(basePackages = {"com.yourcompany.apigateway", "com.yourcompany.commons"})
  public class ApigatewayApplication {
      public static void main(String[] args) {
          SpringApplication.run(ApigatewayApplication.class, args);
      }
  }
  

• 或者直接在测试类上补充@ComponentScan，专门扫描commons的包：

  @RunWith(SpringRunner.class)
  @SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT, classes = ApigatewayApplication.class)
  @ComponentScan(basePackages = "com.yourcompany.commons")
  @TestPropertySource(locations = "classpath:apigateway-test.properties")
  public class YourTestClass {
      // 测试代码
  }
  

2. 确认commons模块的Repository被正确标记为Spring Bean #

虽然主应用能找到，但还是要确认下：

• 如果是Spring Data Repository（比如继承JpaRepository），确保接口正确继承了对应的父接口，Spring会自动为它生成代理Bean，但前提是扫描范围覆盖到。
• 如果是自定义的Repository实现类，要确保它标注了@Repository注解，这样Spring才能识别为Bean。

3. 排查@TestPropertySource的配置是否干扰了Bean加载 #

你的测试类使用了@TestPropertySource，有没有可能配置的properties文件中不小心禁用了Repository的自动配置？比如有没有设置spring.data.jpa.repositories.enabled=false这类属性？

可以先临时注释掉@TestPropertySource，运行测试看看是否能正常启动，排除配置文件的问题。如果注释后正常，再去检查配置文件里的属性。

4. 确保commons模块的配置被测试上下文加载 #

如果commons模块有自己的@Configuration配置类，要确保这个配置类被主应用或者测试类导入。比如在ApigatewayApplication上添加@Import(CommonsConfig.class)，这样测试上下文就能加载到commons模块的所有Bean定义。

5. 验证模块依赖的传递性 #

主模块依赖commons模块时，确保依赖范围是compile（默认就是这个范围），这样测试类也能访问到commons模块的类。如果依赖范围是provided或其他，测试时可能找不到Repository的类，导致Spring无法创建Bean。

先从组件扫描范围开始排查，这是这类问题最常见的原因。如果还是不行，可以再检查其他几个方向。

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