当前位置：首页 > article >正文

透彻理解并解决Mockito模拟框架的单元测试无法运行的问题

article 2025/1/22 23:58:07

本篇的实例基于Maven

IDE (VS Code) 运行

在VS Code 运行的时候，不需要在pom.xml 中添加任何插件就可以在测试类中看到如下的绿色按钮，单击就可以运行使用Mockito 注解 @ExtendWith(MockitoExtension.class) 或是 Mockito 代码方式的测试。
在这里插入图片描述

不使用注解：

**
 * Copyright (C)  Oscar Chen(XM):
 * 
 * Date: 2024-12-07
 * Author: XM
 */
package com.osxm.test.mock;

import static org.mockito.Mockito.mock;
import static org.mockito.Mockito.verify;
import static org.mockito.Mockito.when;
import java.util.List;
import org.junit.jupiter.api.Test;

public class MockMethodTest {
    
    @Test
    public void objectMock() {
        List<String> mockedList = mock(List.class); // 创建一个List接口的mock对象
        when(mockedList.get(0)).thenReturn("first");
        mockedList.get(0);
        verify(mockedList).get(0); 
    }
}

使用注解

//**
 * Copyright (C)  Oscar Chen(XM):
 * 
 * Date: 2024-12-01
 * Author: XM
 */
package com.osxm.test.mock;

import static org.mockito.Mockito.verify;
import static org.mockito.Mockito.when;

import java.util.List;

import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.mockito.Mock;
import org.mockito.junit.jupiter.MockitoExtension;

@ExtendWith(MockitoExtension.class)
public class MockitoUsageTest {

    @Mock
    private List<String> mockedList;

    @Test
    public void objectMock() {
        when(mockedList.get(0)).thenReturn("first");
        mockedList.get(0);
        verify(mockedList).get(0); 
    }
}

如果需要调试模式可以右键单击按钮，在弹出菜单选择Debug Test
在这里插入图片描述

mvn test 命令行运行的问题

但是在命令行使用 mvn test 命令运行的时候，却出现了比较奇怪的现象：

普通的JUnit 测试类和方法能正常运行
使用Mockito 的测试类能找到，但是测试方法找不到，如下图所示：

在这里插入图片描述

为什么呢？这里首先要介绍一下 Maven的插件 maven-surefire-plugin。

maven-surefire-plugin

maven-surefire-plugin是Maven的一个插件，主要用于执行Java应用程序中的单元测试。

主要功能包括：

执行单元测试：maven-surefire-plugin可以自动发现并执行项目中的测试类。它默认使用JUnit来执行测试，但也可以配置为支持其他测试框架，如TestNG。
报告生成：该插件提供详细的测试结果报告，包括测试用例的数量、成功/失败/忽略的数量等，这些报告通常以纯文本（.txt）和XML（.xml）格式生成，并保存在项目的target/surefire-reports目录下。
定制测试执行：maven-surefire-plugin允许用户通过配置来定制测试的执行方式，例如指定特定的测试类或方法进行执行，或者排除某些测试类或方法。

mvn test 运行Mockito 测试的解法

在pom.xml 中添加maven-surefire-plugin 插件：

    <build>
       <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>3.5.2</version>
            </plugin>
        </plugins>
    </build>

再次运行就可以找到Mockito 编写的测试类了。

在这里插入图片描述

问题

那么，问题来了：

为什么VS Code不添加maven-surefire-plugin可以运行单元测试？
为什么在不添加maven-surefire-plugin的状况下，普通的单元测试可以找到并运行，Mockito 的不行了呢？
接下来就解惑这两个问题

###　为什么VS Code不添加maven-surefire-plugin可以运行单元测试？

在IDE中导入Maven项目时，IDE通常会自动读取pom.xml文件，并根据其中的配置来设置项目的构建和测试环境。如果pom.xml中没有显式配置maven-surefire-plugin，IDE可能会使用Maven的默认行为来执行测试。
另外，　IDE通常还提供了测试运行器功能，允许用户直接运行和调试测试类。这些测试运行器可以与Maven的测试框架集成，从而在不依赖maven-surefire-plugin的情况下执行测试。

所以，对于IDE ,可以不依赖pom.xml 的maven-surefire-plugin 就可以运行测试

为什么在不添加maven-surefire-plugin的状况下，普通的单元测试可以找到并运行，Mockito 的不行了呢？

稍微细心一点就可以看到在显式添加maven-surefire-plugin 的前后的差异：
在这里插入图片描述

在pom.xml 显式添加maven-surefire-plugin 之前，使用mvn test 命令其实也使用了maven-surefire-plugin，只是版本比较低，是2.12.4 版。
这个原意就是 Maven内置了一个版本的maven-surefire-plugin，即使项目没有配置，也可以使用这个版本来运行单元测试，但是这里的状况，这个版本相对于Mockito 的版本来说，低了，所以找不到Mockito 的测试。通过添加新版本的
maven-surefire-plugin 就可以解决这个问题。

查看全文

http://www.kler.cn/a/428633.html