Spring MockMvc测试失败：无对应HTTP请求URI映射，请求排查REST API问题

遇到这个问题很常见，我帮你梳理几个最可能的原因和对应的解决办法：

1. 请求URI与控制器映射不匹配 #

这是最常见的触发原因，你需要仔细核对测试代码里的请求路径和控制器的映射规则：

• 你的控制器类上标注了@RequestMapping("/api")，所以所有请求必须携带/api前缀。比如测试时不能直接请求/check，而应该是/api/check或/api/check/{type}。
• 你的@RequestParam("email")没有设置required=false，这意味着必须携带email参数才能匹配这个映射。如果测试时没传email参数，Spring会认为没有符合条件的请求映射，直接返回404。

解决办法：

• 修正测试代码的请求路径，确保包含/api前缀；
• 测试时必须通过.param("email", "xxx@example.com")（多个邮箱可以传多个值：.param("email", "a@x.com", "b@x.com")）携带参数；如果业务允许email可选，给@RequestParam加上required=false。

2. 路径变量与请求参数混淆 #

你的控制器提供了两种路径：/check/{type}（type是路径变量）和/check（type可选）。如果测试时错误地把type当作请求参数传递（比如/api/check?type=xxx），而不是放在路径里（/api/check/xxx），就会匹配不到映射。

解决办法：

• 如果要测试带type的场景，按照路径变量的格式构造请求：get("/api/check/your_type_value")；
• 如果希望用请求参数传递type，需要把控制器里的@PathVariable(name = "type", required = false)改成@RequestParam(name = "type", required = false)。

3. MockMvc测试上下文未正确加载控制器 #

如果你的测试类没有正确配置，Spring可能没扫描到你的ApiController，自然就找不到对应的请求映射了。

解决办法：

• 如果是仅测试Web层，推荐使用@WebMvcTest(ApiController.class)，它会只加载与该控制器相关的Bean，避免加载整个应用上下文，测试更高效；
• 如果用@SpringBootTest，需要额外加上@AutoConfigureMockMvc，确保MockMvc被正确初始化，并且控制器被扫描到。

4. 自定义注解@MyConstraint的问题 #

你的email参数上标注了自定义约束@MyConstraint，如果这个注解的实现有问题（比如没有正确配置@Constraint注解，或者Validator逻辑错误），可能会导致Spring无法正确解析方法参数，进而无法识别请求映射。

解决办法：

• 临时去掉@MyConstraint注解，重新运行测试，如果能正常匹配映射，说明问题出在这个自定义注解上；
• 检查@MyConstraint的实现：确保它标注了@Constraint(validatedBy = YourValidator.class)，并且对应的Validator类正确实现了ConstraintValidator接口。

示例正确测试代码 #

这里给你一个符合要求的测试类示例，参考调整你的测试代码：

@WebMvcTest(ApiController.class)
class ApiControllerTest {

    @Autowired
    private MockMvc mockMvc;

    // 测试不带type的场景
    @Test
    void testCheckWithoutType() throws Exception {
        mockMvc.perform(get("/api/check")
                        .param("email", "test1@example.com", "test2@example.com")
                        .accept(MediaType.APPLICATION_JSON))
                .andExpect(status().isOk());
    }

    // 测试带type的场景
    @Test
    void testCheckWithType() throws Exception {
        mockMvc.perform(get("/api/check/user_type")
                        .param("email", "test@example.com")
                        .accept(MediaType.APPLICATION_XML))
                .andExpect(status().isOk());
    }
}

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