JUnit测试未触发目标@PostMapping接口方法的异常问题排查

结合你描述的场景——测试返回200 OK、路径匹配正确，但断点无法进入接口方法，我整理了几个最常见的排查方向：

• 参数绑定失败被全局异常处理器"隐藏"了
  你的接口方法参数是Bar bar，Spring需要把传入的JSON自动反序列化为Bar对象。如果JSON字段和Bar类的属性不匹配（比如字段名大小写不一致、缺少必填字段、类型不兼容），会触发BindException或HttpMessageNotReadableException。但如果你的项目中存在全局异常处理器（比如用@RestControllerAdvice+@ExceptionHandler），并且该处理器捕获这些异常后返回了200状态码，就会出现测试"成功"但实际没进入方法体的情况。
  👉 排查建议：临时注释全局异常处理器，重新运行测试，看是否会抛出绑定异常；或者在测试中添加andExpect(content().json(...))断言返回内容是否符合Foo对象的预期。

• MockMvc加载的上下文未正确包含目标控制器
  如果你的测试类使用@WebMvcTest，但没有指定目标控制器（比如@WebMvcTest(YourController.class)），Spring可能只加载了部分组件，导致目标控制器未被注册到MockMvc的上下文中。更可能的情况是存在多个控制器映射了同一个/vpos/notify路径，测试请求匹配到了另一个控制器的方法，而非你设置断点的那个。
  👉 排查建议：在测试中打印请求映射详情，比如添加mockMvc.getDispatcherServlet().getHandlerMappings()并输出，查看/vpos/notify对应的处理器是哪个类。

• 断点配置或IDE的问题
  有时候不是代码的问题，而是断点没生效：

  • 如果你的控制器被AOP代理（比如加了@Transactional、自定义切面），直接在原始类的方法上设置断点可能不会触发，需要在代理类的方法上设置（IDE通常会提示"断点设置在代理类"，或者你可以开启IDE的"显示代理类"选项）；
  • 检查断点是否被意外禁用（IDE中断点图标是否变灰），或者设置了条件断点但条件永远不满足；
  • 尝试重启IDE或重新构建项目，有时候IDE的调试缓存会导致断点不生效。

• 请求前置处理提前返回了响应
  如果项目中存在Filter或RequestBodyAdvice这类前置处理器，它们可能在请求到达控制器方法之前就处理了请求并返回了200响应。比如某个过滤器验证token后直接返回了空的200响应，而没有继续转发请求到控制器。
  👉 排查建议：临时注释过滤器或RequestBodyAdvice，重新运行测试；或者在这些组件中添加日志，查看请求是否被提前拦截。

• 测试中的JSON内容存在隐性问题
  虽然你用TestDataFactory生成了JSON，但可能JSON的格式存在隐性问题（比如某个字段值为null但Bar类对应的属性不允许为null，或者日期格式不匹配），导致Spring在解析请求体时出错，但又没有抛出异常（比如某些序列化框架的静默失败），进而跳过了控制器方法的执行。
  👉 排查建议：手动打印jsonContent的内容，和Bar类的属性逐一对比；或者在接口方法的第一行添加日志（比如System.out.println("进入接口方法")），运行测试看是否会输出该日志。

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