使用JUnit和Spring测试Servlet与Filter：MockMvc集成测试问题咨询

我之前在做原生Servlet和Filter的集成测试时，也遇到过和你一模一样的问题——MockMvc默认对Spring MVC的Controller支持很友好，但原生Servlet得手动注册到Mock上下文里才行！下面给你一步步解决的方法：

1. 手动构建MockServletContext并注册组件 #

核心思路是创建一个MockServletContext实例，把你的Filter和Servlet都注册进去，再基于这个上下文构建MockMvc。代码示例如下：

import org.springframework.mock.web.MockServletContext;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.test.web.servlet.setup.MockMvcBuilders;
import org.springframework.web.context.support.XmlWebApplicationContext;
import org.junit.jupiter.api.BeforeEach;

// 假设你的Filter和Servlet类是AuthenticationFilter和LoggingServlet
public class ServletFilterIntegrationTest {

    private MockMvc mockMvc;

    @BeforeEach
    void setUp() {
        // 初始化MockServletContext
        MockServletContext servletContext = new MockServletContext();
        
        // 注册LoggingServlet，并映射到请求路径
        servletContext.addServlet("LoggingServlet", LoggingServlet.class)
                      .addMapping("/user/query");
        
        // 注册AuthenticationFilter，并关联到LoggingServlet
        servletContext.addFilter("AuthenticationFilter", AuthenticationFilter.class)
                      .addMappingForServletNames(null, false, "LoggingServlet");

        // 构建Spring Web上下文并关联MockServletContext
        XmlWebApplicationContext webContext = new XmlWebApplicationContext();
        webContext.setServletContext(servletContext);
        webContext.refresh();

        // 初始化MockMvc
        mockMvc = MockMvcBuilders.webAppContextSetup(webContext).build();
    }
}

2. 编写测试用例验证流程 #

上下文配置好后，就可以正常用MockMvc模拟请求，验证Filter和Servlet的完整执行流程了：

import org.junit.jupiter.api.Test;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;

@Test
void testUserQueryRequestFlow() throws Exception {
    // 模拟浏览器发起的查询请求，带上Filter需要的认证信息（比如token）
    mockMvc.perform(get("/user/query")
                    .header("Authorization", "Bearer test-valid-token"))
            // 验证请求返回状态码
            .andExpect(status().isOk())
            // 验证Servlet返回的用户信息内容
            .andExpect(content().string(containsString("username: testUser")));
}

3. 额外注意点 #

• 如果你的Servlet依赖Spring管理的Bean（比如用户查询Service），记得在XmlWebApplicationContext或者AnnotationConfigWebApplicationContext中配置对应的Bean定义，确保Servlet能正确注入依赖。
• 如果你使用Spring Boot，可以结合@WebServlet、@WebFilter和@ServletComponentScan注解自动注册组件，但测试时还是需要手动构建上下文确保这些组件被加载到Mock环境中。
• 调试阶段可以在Filter和Servlet中添加日志，验证请求是否按预期经过Filter并进入Servlet处理。

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