Spring Boot @WebMvcTest如何排除CrudRepository接口加载？

核心原因 #

@WebMvcTest默认会扫描当前包及子包下的所有Spring组件，包括被@Repository标记的JPA仓库接口。单纯使用excludeFilters可能因过滤时机或规则匹配不精准，导致仓库接口仍被加载。

正确排除方案 #

方案1：精准指定加载的配置类（推荐） #

既然你是通过ViewControllerRegistry注册首页视图，没有专用Controller，可直接让@WebMvcTest只加载注册视图的配置类（比如WebConfig），彻底隔离其他组件：

@WebMvcTest(WebConfig.class)
class HomePageMvcTest {
    // 测试逻辑
}

这种方式下，ApplicationContext只会加载WebMvc相关配置，完全不会触及JPA仓库。

方案2：精准配置排除过滤器 #

如果需要保留部分Web组件但排除所有JPA仓库，可通过excludeFilters同时匹配接口类型和注解：

@WebMvcTest(excludeFilters = {
    @ComponentScan.Filter(type = FilterType.ASSIGNABLE_TYPE, value = CrudRepository.class),
    @ComponentScan.Filter(type = FilterType.ANNOTATION, value = Repository.class)
})
class HomePageMvcTest {
    // 测试逻辑
}

双重过滤确保所有继承CrudRepository的接口、以及被@Repository标记的组件都不会被加载。

方案3：@MockBean绕过（补充细节） #

如果只是临时绕过加载失败，可给所有JPA仓库添加@MockBean，让Spring创建Mock实例而非加载真实仓库：

@WebMvcTest
class HomePageMvcTest {
    @MockBean
    private UserRepository userRepository; // 你的CrudRepository实现类

    // 测试逻辑
}

通用组件排除方法 #

1. 按类型排除：用FilterType.ASSIGNABLE_TYPE指定具体类/接口，适合明确知道目标类的场景：

   @WebMvcTest(excludeFilters = @ComponentScan.Filter(type = FilterType.ASSIGNABLE_TYPE, value = XXService.class))
   

2. 按注解排除：用FilterType.ANNOTATION过滤带有特定注解的组件，比如排除所有@Service：

   @WebMvcTest(excludeFilters = @ComponentScan.Filter(type = FilterType.ANNOTATION, value = Service.class))
   

3. 按正则匹配类名：用FilterType.REGEX批量排除符合命名规则的类，比如所有带Repository后缀的类：

   @WebMvcTest(excludeFilters = @ComponentScan.Filter(type = FilterType.REGEX, pattern = ".*Repository"))
   

4. 自定义过滤器：实现TypeExcludeFilter编写复杂逻辑，比如按包路径或继承关系过滤：

   public class RepositoryExcludeFilter extends TypeExcludeFilter {
       @Override
       public boolean match(MetadataReader metadataReader, MetadataReaderFactory metadataReaderFactory) throws IOException {
           String className = metadataReader.getClassMetadata().getClassName();
           return CrudRepository.class.isAssignableFrom(Class.forName(className));
       }
   }
   

   测试类中使用：

   @WebMvcTest(excludeFilters = @ComponentScan.Filter(type = FilterType.CUSTOM, value = RepositoryExcludeFilter.class))
   

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