如何用Mockito测试带参数的Spring PostMapping控制器方法？

我之前踩过一模一样的坑——用Mockito测试带参数的@PostMapping控制器方法时，明明预期是跳转的302状态码，结果却返回了400 Bad Request。后来调整了测试的构造方式，终于正常跑通了，分享一下我的排查思路和解决办法：

先说说为什么会返回400 #

400状态码几乎都是请求参数不匹配或者绑定失败导致的：

• 控制器方法需要的参数没传全，或者参数名称拼写错了
• 参数类型不匹配（比如把字符串传给了Integer类型的参数）
• 如果是用@ModelAttribute接收对象参数，没有正确传递对象的属性
• 测试时没有用Spring MVC的测试上下文，单纯Mock的话没法正确处理参数绑定

调整后的正确测试示例 #

假设你的控制器方法是这样的：

@PostMapping("/user/submit")
public String submitUserInfo(@RequestParam("userId") Long userId, 
                             @ModelAttribute UserForm userForm,
                             RedirectAttributes redirectAttributes) {
    // 业务逻辑：调用服务处理请求
    yourService.saveUser(userForm);
    redirectAttributes.addFlashAttribute("successMsg", "信息提交成功");
    return "redirect:/user/detail";
}

那测试代码应该这么写：

@WebMvcTest(UserController.class)
public class UserControllerTest {

    @Autowired
    private MockMvc mockMvc;

    @MockBean
    private YourService yourService; // 模拟控制器依赖的服务类

    @Test
    public void testSubmitUserInfo_ReturnsRedirect() throws Exception {
        // 构造完整的请求参数，严格匹配控制器的参数要求
        mockMvc.perform(post("/user/submit")
                        .param("userId", "1001") // 匹配@RequestParam的参数
                        .param("userForm.username", "testNick") // @ModelAttribute对象的属性用"对象名.属性名"传递
                        .param("userForm.email", "test@example.com"))
                .andExpect(status().is3xxRedirection()) // 验证返回302
                .andExpect(redirectedUrl("/user/detail")); // 验证跳转地址
    }
}

关键调整点 #

1. 用@WebMvcTest替代单纯的Mockito：这个注解会自动配置Spring MVC的测试上下文，包括MockMvc、参数解析器这些组件，能正确处理请求参数的绑定，比自己手动Mock控制器靠谱多了。
2. 参数传递要精准：
   • 对于@RequestParam的单个参数，直接用.param("参数名", "值")传递
   • 对于@ModelAttribute的对象参数，必须用对象名.属性名的格式传递属性值，比如userForm.username
   • 如果是用@RequestBody接收JSON请求体，要改成.content("{\"username\":\"testNick\"}")并设置.contentType(MediaType.APPLICATION_JSON)
3. 确保参数无遗漏：控制器方法里声明的所有必填参数都要在请求里传到位，少一个都可能触发400。

最后总结 #

之前返回400本质就是请求参数没构造对，导致Spring没法完成参数绑定。只要调整测试的构造方式，用@WebMvcTest搭建正确的测试环境，同时精准传递所有参数，就能得到预期的302跳转状态码了。

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