By name: spring-mvc-testing description: "Boot 4+ replaced MockMvc assertions with MockMvcTester — incompatible API your training data gets wrong. Read before writing any @WebMvcTest. Triggers: @WebMvcTest, MockMvc, MockMvcTester, @RestController, jsonPath, @GetMapping, @PostMapping, @AutoConfigureMockMvc, MockMvcRequestBuilders, status().isOk(), @RestControllerAdvice, contentType(APPLICATION_JSON)." version: 0.1.0 license: Apache-2.0
Spring MVC Testing
Signals: @WebMvcTest, MockMvc, jsonPath, @AutoConfigureMockMvc, @RestController, MockMvcRequestBuilders, MockMvcResultMatchers, objectMapper
Tested With
- Spring Boot 3.2+ / Spring Boot 4.x
- Spring Framework 6.x / Spring Framework 7.x
- Spring Security 6.x / 7.x (auto-configured in
@WebMvcTest) - JUnit 5
Do NOT Use This Skill When
- Testing authentication, authorization, CSRF, JWT, or OAuth2 specifically → use
spring-security-testing - Testing reactive endpoints (
WebFlux,WebClient, SSE) → usespring-webflux-testing - Testing JPA repositories or database persistence → use
spring-jpa-testing - Testing WebSocket or STOMP messaging → use
spring-websocket-testing - Writing pure unit tests without a Spring context → use
spring-testing-fundamentals
When to Read References
| Situation | Read |
|---|---|
Setting up @WebMvcTest, MockMvc configuration, static imports |
references/mvc-rest-testing-patterns.md |
| GET, POST, PUT, DELETE request patterns | references/mvc-rest-testing-patterns.md |
jsonPath assertions, response headers, multipart uploads |
references/mvc-rest-testing-patterns.md |
Testing @Valid bean validation, @RestControllerAdvice exception handlers |
references/mvc-rest-testing-patterns.md |
Boot 4 RestTestClient migration |
references/mvc-rest-testing-patterns.md |
| Anti-patterns and common mistakes | references/mvc-rest-testing-patterns.md |