Spring Boot Web测试:已编写Controller类,为何.isNotNull()断言会执行失败?
问题排查方向
你碰到的“用isNull断言能通过、但预期从接口拿到的返回值是null”的情况,本质是测试链路根本没打通到你写的Controller逻辑上,不是你Controller的功能写坏了,基本都是下面几个新手高频踩坑点导致的:
高频踩坑原因
- 测试类的MockMvc配置缺项
不少人写测试时只加了@SpringBootTest,忘了搭配@AutoConfigureMockMvc,这种情况下Spring不会把真实的Web运行上下文和MockMvc做绑定,发出的请求根本不会路由到你写的Controller接口上。还有的人图省事直接手动声明private MockMvc mockMvc;,忘了用@Autowired注入容器里初始化好的实例,跑测试时拿这个空对象执行请求,拿到的结果自然全是null。 - 包扫描路径不匹配
Spring Boot启动类默认只会扫描自身所在包及所有子包下的组件。如果你把Controller写在了和启动类平级、甚至更上层的非扫描路径里,容器启动时根本不会把Controller注册成可用的Bean,发出去的请求找不到对应的处理器,自然拿不到预期的返回内容。 - 断言逻辑本身是无效的“假通过”
这是最容易迷惑新手的场景:你把要断言的响应值存成了测试类的全局变量,但写MockMvc调用链路的时候,压根没把接口返回的响应内容赋值给这个变量。那这个变量从始至终都是null,你拿它做isNull断言,不管Controller的逻辑写的对不对、接口路径对不对,测试都会显示通过——本质上这个测试根本没执行任何有效校验,绿灯完全是假象。
可直接参照的正确写法
照着写基本能避开这类配置问题:
@SpringBootTest @AutoConfigureMockMvc class HelloControllerTest { @Autowired private MockMvc mockMvc; @Test void testHelloEndpoint() throws Exception { // 直接在请求链路里完成所有断言,不绕弯存全局变量 mockMvc.perform(get("/hello")) .andExpect(status().isOk()) .andExpect(content().string("Hello, World!")); } }
快速排障步骤
- 翻测试执行的控制台日志,检查有没有对应接口路径的访问日志,如果完全没有请求打到Controller的日志,优先检查测试类的两个核心注解有没有加全、Controller所在的包是不是在启动类的扫描范围内
- 别用全局变量存响应值再做断言,所有和响应内容相关的校验,直接写在
mockMvc.perform()的链式调用里,避免出现变量赋值遗漏导致的假通过 - 确认你断言的是接口返回的响应体字符串内容,不是
MvcResult对象、原始请求对象这类本身可能为空的中间对象。
提醒:你现在能跑通的isNull测试完全没有实际测试价值,哪怕你把所有接口路径全写错,这个测试都会显示绿色通过,一定要把测试链路打通到真正拿到Controller返回的实际响应内容为止。
内容的提问来源于stack exchange,提问作者Burakhan Aksoy
相关产品推荐
相关产品推荐

