PowerMockito单元测试中的Invalid use of argument matchers问题详解

Myth丶恋晨 2022-12-18 11:53 336阅读 0赞

# PowerMockito单元测试中的Invalid use of argument matchers问题详解   #

首先，简单说说PowerMockito进行单元测试的三部曲：

1.  打桩，即为非测试目标方法设置返回值，这些返回值在测试目标方法中被使用。
2.  执行测试，调用测试目标方法。
3.  验证测试结果，如测试方法是否被执行，测试结果是否正确等。

其次，在使用PowerMockito框架进行单元测试的过程中，经常遇到如下异常：

1.  `Invalid use of argument matchers!`
2.  `0 matchers expected, 1 recorded:`
3.  `-> at com.mycompany.myproject.mypackage.MyTestClass.myTestMethod(MyTestClass.java:65)`
4.  `This exception may occur if matchers are combined with raw values:`
5.  `//incorrect:`
6.  `someMethod(anyObject(), "raw String");`
7.  `When using matchers, all arguments have to be provided by matchers.`
8.  `For example:`
9.  `//correct:`
10. `someMethod(anyObject(), eq("String by matcher"));`
11. `For more info see javadoc for Matchers class.`

乍一看似乎找不到北，先看看下面的代码再说。

被测试方法如下：

1.  `public boolean toggleOffOn(int delaySeconds) {`
2.  `boolean off = powerOff();`
3.  `sleep(delaySeconds);`
4.  `boolean on = powerOn();`
5.  `return off && on;`
6.  `}`

测试用例中的测试方法片段如下：

1.  `PowerMockito.when(ps.powerOn()).thenReturn(true);`
2.  `PowerMockito.when(ps.powerOff()).thenReturn(true);`
3.  `PowerMockito.when(ps.toggleOffOn(Mockito.anyInt())).thenReturn(true);//throws exception here`

异常分析：

从异常的位置来看，该异常发生在打桩阶段，还未执行到真正的测试。

从异常的信息来看，显然违反了一个Mockito框架中的Matchers匹配参数的规则。根据[Matchers][]文档如下，在打桩阶段有一个原则，**一个mock对象的方法，如果其若干个参数中，有一个是通过Matchers提供的，则该方法的所有参数都必须通过Matchers提供。**而不能是有的参数通过Matchers提供，有的参数直接给出真实的具体值。

1.  `If you are using argument matchers, all arguments have to be provided by matchers.`
2.  `E.g: (example shows verification but the same applies to stubbing):`
3.   
4.  `verify(mock).someMethod(anyInt(), anyString(), eq("third argument"));`
5.  `//above is correct - eq() is also an argument matcher`
6.  `verify(mock).someMethod(anyInt(), anyString(), "third argument");`
7.  `//above is incorrect - exception will be thrown because third argument is given without argument matcher.`
8.   
9.  `Matcher methods like anyObject(), eq() do not return matchers. Internally, they record a matcher on a stack and return a dummy value (usually null).`

上述文档中给出的示例，可以使用eq()方法将真实的具体值转换为Matchers提供的值。

解决方法：

给出具体值  
PowerMockito.when(ps.toggleOffOn(3)).thenReturn(true);  
或直接去掉（仅适用于该测试用例）  
PowerMockito.when(ps.toggleOffOn(Mockito.anyInt())).thenReturn(true);

注意：在Mockito 1.x中，org.mockito.Matchers已经过时，org.mockito.Mockito继承自Matchers，用以取代Matchers。

参考链接：

http://static.javadoc.io/org.mockito/mockito-core/1.10.19/org/mockito/Matchers.html

[Matchers]: http://static.javadoc.io/org.mockito/mockito-core/1.10.19/org/mockito/Matchers.html