使用PowerMock模拟私有方法时遭遇@NotNull注解参数异常

出现java.lang.IllegalArgumentException: Argument for @NotNull parameter X of Y must not be null异常，核心原因是JetBrains的@NotNull注解在运行时会对参数做非空校验，而PowerMock的匹配器使用方式可能触发了这一校验逻辑。以下是几种可行的解决办法：

1. 确保匹配器绑定的参数本身非null #

先检查测试代码中configuration变量的初始化状态：

• 必须保证configuration是真实的非null实例（比如通过new Configuration()创建），不能为null。即使使用eq(configuration)，如果变量本身是null，传递给带@NotNull的参数时会直接触发校验异常。

2. 切换为doReturn语法模拟 #

PowerMock的when语法会先尝试调用目标方法（触发参数校验），而doReturn语法是先设定返回值再模拟调用，可避免提前触发@NotNull校验：

PowerMockito.doReturn(dataModel)
    .when(service, "computeDataModel", eq(user), eq(configuration), eq(providedDataModel));

3. 使用isNotNull()匹配器 #

明确指定参数非null，替代eq或any匹配器，避免校验逻辑误判：

PowerMockito.when(service, "computeDataModel", eq(user), Mockito.isNotNull(), eq(providedDataModel))
    .thenReturn(dataModel);

4. 临时关闭@NotNull运行时校验 #

如果上述方法都无效，可以在测试的JVM参数中添加以下参数，关闭JetBrains注解的运行时校验：

-Djetbrains.annotations.notnull=disabled

注意：这是全局设置，可能影响其他依赖@NotNull校验的测试，建议仅在当前测试类的配置中添加。

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