能否用REST Assured测试Servlet过滤器？Spring Boot过滤器测试解惑

这种情况太正常啦！我之前做Spring Boot测试的时候也踩过这个坑😉

原因很简单：你用的RestAssuredMockMvc.standaloneSetup()是独立测试模式，它的设计目标是快速、隔离地测试单个控制器，并不会自动加载Spring容器里的组件——包括你用@WebFilter标记的过滤器。这个模式下，RestAssured只会初始化你显式传入的那个控制器，完全跳过了Spring的组件扫描、自动配置这些逻辑，所以过滤器自然不会被执行。

怎么让过滤器在测试里生效？ #

有两种常用的解决办法，看你更偏向哪种测试风格：

方法1：手动给独立模式添加过滤器 #

直接在初始化MockMvc的时候，把你的过滤器加进去就行，代码大概是这样：

RestAssuredMockMvc.standaloneSetup(
    MockMvcBuilders.standaloneSetup(new MyController())
        .addFilters(new MyWebFilter()) // 手动注册过滤器
);

这种方式适合你只想测试单个控制器，不想加载整个Spring上下文的场景，测试速度会更快。

方法2：用Spring上下文模式（更贴近真实运行环境） #

如果希望测试行为和实际应用完全一致，那建议改用Spring上下文来启动测试，也就是用@SpringBootTest加载整个应用环境，再结合@AutoConfigureMockMvc注入MockMvc：

@SpringBootTest
@AutoConfigureMockMvc
public class MyControllerTest {

    @Autowired
    private MockMvc mockMvc;

    @BeforeEach
    void setUp() {
        RestAssuredMockMvc.mockMvc(mockMvc);
    }

    @Test
    void shouldHaveCustomHeader() {
        boolean headerExists = given()
            .when()
            .get()
            .headers()
            .hasHeaderWithName("my-header");
        
        assertTrue(headerExists);
    }
}

这种模式下，Spring会自动扫描并注册你的@WebFilter过滤器，和应用实际运行时的逻辑完全一致，测试结果也更可靠。

再补充一句 #

独立模式虽然轻便，但它毕竟是“孤立”的测试，很多Spring的自动配置、组件依赖都不会生效。如果你的控制器或者过滤器依赖了其他Spring管理的Bean，那独立模式可能会让你遇到更多依赖缺失的问题，这时候用Spring上下文模式反而更省心。

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