Spring Boot 3中如何结合MockMVC与CSRF进行测试？

API 探路者

2026-7-4

Spring Boot 3.1.4中MockMVC测试POST接口的CSRF令牌传递方案

问题根源

你遇到的导入失败问题，是因为org.springframework.security.test下的工具类属于测试专用依赖，而你只引入了运行时的spring-boot-starter-security，这个依赖不包含测试相关的代码。

解决步骤

1. 添加正确的测试依赖

需要在构建文件中引入spring-security-test测试依赖：

Gradle 写法

testImplementation 'org.springframework.security:spring-security-test'

Maven 写法

<dependency>
    <groupId>org.springframework.security</groupId>
    <artifactId>spring-security-test</artifactId>
    <scope>test</scope>
</dependency>

注意：Spring Boot 3.x版本中，这个依赖不需要指定版本，会通过Spring Boot的依赖管理自动匹配对应版本。

2. 使用CSRF令牌处理器

添加依赖后，你之前的代码写法就可以正常工作了。csrf()后置处理器会自动生成有效的CSRF令牌，并将其添加到请求中（根据请求类型，会自动选择放在请求参数或X-XSRF-TOKEN请求头里）：

import static org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.*;

@AutoConfigureTestEntityManager
@SpringBootTest
@AutoConfigureMockMvc
class MyControllerTest {

    @Autowired
    private MockMvc mockMvc;

    @Test
    void postShouldReturnOkForValidInput() throws Exception {
        mockMvc.perform(post(Endpoints.LOG)
                .with(csrf()) // 自动添加CSRF令牌
                .content("{\"key\":\"value\"}") // 替换为你的有效JSON输入
                .contentType(MediaType.APPLICATION_JSON)
        ).andExpect(status().isOk());
    }
}