IntelliJ Debug运行Mockito mock接口测试报空指针异常

• 测试类中原有Mock配置代码：

when(sqlSession.getMapper(ArgumentMatchers.eq(AlertSignalMstMapper.class))).thenReturn(alertSignalMstMapper);

其中AlertSignalMstMapper为接口类型。

• 命令行执行mvn test运行测试时，用例可正常通过；但使用IntelliJ Debug模式运行测试时，被测类中以下代码触发空指针异常：

List<AlertSignalMst> alertSigMsts = sqlSession.getMapper(AlertSignalMstMapper.class).getMstCodes();

• 调试确认异常原因：该行代码中sqlSession.getMapper(AlertSignalMstMapper.class)返回值为null。
• 复现验证：将测试类的JUnit4注解导入import org.junit.Test;替换为JUnit Jupiter（JUnit5）的导入import org.junit.jupiter.api.Test;后，该行代码可正常返回预设的mock对象，异常消失。

• Java 17
• Maven
• Spring Boot
• Mockito 4.5
• JUnit 4.13.2

该问题属于JUnit4与Mockito集成时的初始化逻辑兼容问题，和IntelliJ核心配置无关：
使用JUnit4的@Test注解时，如果没有显式指定Mockito对应的运行器或初始化规则，Mock对象的初始化、桩匹配逻辑依赖类加载时的隐式触发。命令行执行mvn test时，Maven Surefire插件的类加载顺序刚好能让桩匹配逻辑正常命中；但IntelliJ Debug模式下会插入调试字节码增强、调整类加载顺序，导致ArgumentMatchers.eq()的类型匹配校验失败，配置的桩逻辑没有被触发，最终返回默认值null。
切换到JUnit Jupiter的@Test注解后可正常运行，是因为Spring Boot默认绑定的Mockito-JUnit5扩展会主动完成Mock初始化、桩匹配的字节码适配，不受IDE调试模式的类加载逻辑影响。

二选一即可：

1. 保留JUnit4的修复方式
   给测试类添加@RunWith(MockitoJUnitRunner.class)注解，或者在@Before标注的测试初始化方法中显式调用MockitoAnnotations.openMocks(this)，强制完成Mockito初始化。同时简化桩配置，去掉多余的eq()匹配器包装，减少匹配器识别异常的概率，修改后桩代码如下：

   when(sqlSession.getMapper(AlertSignalMstMapper.class)).thenReturn(alertSignalMstMapper);
   

2. 推荐方案：迁移到JUnit Jupiter（JUnit5）
   也就是已验证可行的方案，将测试类中所有JUnit4的注解、导入替换为JUnit Jupiter对应的实现。Spring Boot对JUnit5的集成更完善，不会出现命令行和IDE运行行为不一致的问题，也是官方默认推荐的测试框架版本。

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