升级至Spring Boot 2.6.x后Mockito测试出现NullPointerException及MockitoHint未使用提示问题求助

我之前在升级Spring Boot到2.6.x版本时也碰到过类似的Mockito相关问题，结合你给出的错误日志和代码片段，给你梳理几个实用的排查方向和解决办法：

1. 优先检查Mockito版本兼容性 #

Spring Boot 2.6.x默认依赖的是Mockito 4.x系列版本，如果你之前项目手动指定了老版本的Mockito（比如2.x），升级后很容易出现API行为差异或依赖冲突。

• 建议直接使用Spring Boot的依赖管理来统一版本，避免手动指定：

  <!-- Maven示例，无需手动写版本号，Spring Boot会自动适配 -->
  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-test</artifactId>
      <scope>test</scope>
  </dependency>
  

• 如果之前手动引入了Mockito依赖，尝试移除它，改用Spring Boot提供的默认版本。

2. 验证参数匹配是否精准（重点关注MockitoHint提示） #

错误日志里的MockitoHint明确提到了参数匹配问题，这大概率是打桩的匹配器和实际调用的参数不匹配，导致打桩失效，方法返回null触发NPE。

• 检查tryPackage方法的实际调用参数：比如第四个参数是List的具体泛型类型（比如List<String>），可以尝试用anyListOf(String.class)替代anyList()来做更精确的匹配；
• 临时替换匹配器为具体值测试：比如把anyList()换成Arrays.asList("test")，如果NPE消失，说明就是匹配器的问题；
• 开启Mockito严格模式，获取更详细的匹配错误：

  // 在测试类的静态代码块中添加
  static {
      Mockito.mockitoSession()
          .strictness(Strictness.STRICT_STUBS)
          .startMocking();
  }
  

  这个模式会严格校验打桩和实际调用的匹配关系，给出更具体的不匹配提示。

3. 确认Mock实例是否正确初始化 #

NPE也可能是packageControl本身为null，而不是方法返回值为null：

• 检查packageControl是否用@Mock注解或Mockito.mock(PackageControl.class)正确创建；
• 确认Mock实例是否被正确注入到测试类中（比如用@InjectMocks或者手动赋值）；
• 可以在打桩前打印packageControl实例，正常情况下应该输出类似PackageControl$MockitoMock@xxxx的内容，而不是null。

4. 排查Spring Boot测试上下文的变化 #

Spring Boot 2.6.x对测试上下文的缓存和加载逻辑做了调整，可能导致Mock实例没有被正确初始化：

• 尝试在测试方法上添加@DirtiesContext注解，强制重新加载测试上下文，看是否能解决问题；
• 确认测试类的注解是否正确：比如使用@SpringBootTest时是否指定了正确的启动类，切片测试（如@WebMvcTest）是否正确包含了需要Mock的类。

5. 检查方法重载导致的匹配混淆 #

如果PackageControl类中有多个重载的tryPackage方法，Mockito可能匹配到了错误的方法，导致打桩无效：

• 仔细核对打桩的方法签名（参数数量、类型、泛型）和实际调用的方法是否完全一致；
• 可以通过明确指定参数类型来避免匹配错误：

  when(packageControl.tryPackage(anyString(), anyString(), anyString(), any(List.class))).thenReturn("XXXXXX");
  

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