使用 Mockito 进行 Service 层单元测试：一份实践指南-java教程-PHP中文网

使用 Mockito 进行 Service 层单元测试：一份实践指南

碧海醫心

发布： 2025-11-02 19:11:30

原创

756人浏览过

使用 mockito 进行 service 层单元测试：一份实践指南

本文旨在帮助开发者掌握使用 Mockito 框架对 Spring Boot 项目中的 Service 层进行单元测试的关键技术。我们将重点讲解如何有效地 Mock 依赖的 DAO 层和其他 Service 层，并提供示例代码和常见问题的解决方案，助力你编写高质量、可维护的单元测试。

在 Spring Boot 项目中，Service 层通常负责处理业务逻辑，并依赖于 DAO 层进行数据访问，以及可能依赖于其他 Service 层来完成复杂的业务流程。为了编写有效的 Service 层单元测试，我们需要隔离被测试 Service 与其依赖项，以便专注于测试 Service 自身的逻辑。Mockito 是一个强大的 Java Mocking 框架，可以帮助我们实现这一目标。

1. MockBean 的使用

在 Spring Boot 测试中，@MockBean 注解可以用来替换 Spring 上下文中的 Bean。这对于 Mock 依赖的 DAO 层和其他 Service 层非常有用。

示例：

假设我们有以下 Service 接口和实现类：

青柚面试

简单好用的日语面试辅助工具

查看详情

public interface ExamService {
    int insertScore(RequestModel request) throws IOException;
}

@Service
public class ExamServiceImpl implements ExamService {

    private final ScoreDAO scoreDAO;
    private final SubjectService subjectService;
    private final TeacherDAO teacherDAO;
    private final StudentDAO studentDAO;

    @Autowired
    public ExamServiceImpl(ScoreDAO scoreDAO, SubjectService subjectService, TeacherDAO teacherDAO, StudentDAO studentDAO) {
        this.scoreDAO = scoreDAO;
        this.subjectService = subjectService;
        this.teacherDAO = teacherDAO;
        this.studentDAO = studentDAO;
    }

    @Override
    public int insertScore(RequestModel request) throws IOException {
        List<TeacherModel> teacher = teacherDAO.getNameList(request);
        List<StudentModel> student = studentDAO.findStudentList(teacher.get(0).getName(), request.getStudentScore);

        String nameStudent = student.get(0).getFirstName() + student.get(0).getLastName();
        SubjectModel subject = subjectService.getNameSubject(request, nameStudent);

        ScoreModel score = new ScoreModel();
        score.setStudentName(request.getStudentName);
        score.setScore(request.getStudentScore);
        score.setSubject(subject.getName);

        return scoreDAO.insert(score);
    }
}

登录后复制

为了测试 ExamServiceImpl，我们需要 Mock ScoreDAO、SubjectService、TeacherDAO 和 StudentDAO。

@SpringBootTest
public class ExamServiceImplTest {

    @MockBean
    private ScoreDAO scoreDAO;

    @MockBean
    private SubjectService subjectService;

    @MockBean
    private TeacherDAO teacherDAO;

    @MockBean
    private StudentDAO studentDAO;

    @Autowired
    private ExamService examService;

    @Test
    void insertScoreTest() throws IOException {
        // 准备 Mock 数据
        TeacherModel resTeacher = new TeacherModel();
        resTeacher.setName("test Teacher");
        List<TeacherModel> teacherList = new ArrayList<>();
        teacherList.add(resTeacher);

        StudentModel studentData = new StudentModel();
        studentData.setFirstName("firstname");
        studentData.setLastName("lastname");
        List<StudentModel> studentList = new ArrayList<>();
        studentList.add(studentData);

        SubjectModel resFromSubject = new SubjectModel();
        resFromSubject.setSubject("Math");

        // 配置 Mock 行为
        Mockito.when(teacherDAO.getNameList(Mockito.any(RequestModel.class))).thenReturn(teacherList);
        Mockito.when(studentDAO.findStudentList(Mockito.anyString(), Mockito.anyString())).thenReturn(studentList);
        Mockito.when(subjectService.getNameSubject(Mockito.any(RequestModel.class), Mockito.anyString())).thenReturn(resFromSubject);
        Mockito.when(scoreDAO.insert(Mockito.any(ScoreModel.class))).thenReturn(1);

        // 执行测试
        int resultTest = examService.insertScore(new RequestModel());

        // 验证结果
        Assertions.assertEquals(1, resultTest);
    }
}

登录后复制

解释：

@SpringBootTest 注解用于启动 Spring Boot 测试上下文。
@MockBean 注解用于替换 Spring 上下文中的 ScoreDAO、SubjectService、TeacherDAO 和 StudentDAO Bean，用 Mockito 创建的 Mock 对象替换。
Mockito.when() 方法用于配置 Mock 对象的行为。例如，Mockito.when(scoreDAO.insert(Mockito.any(ScoreModel.class))).thenReturn(1); 表示当调用 scoreDAO.insert() 方法时，无论传入什么 ScoreModel 对象，都返回 1。
Mockito.any() 方法是一个参数匹配器，表示匹配任何参数。
examService.insertScore() 方法是我们要测试的方法。
Assertions.assertEquals() 方法用于验证测试结果。

2. 常见问题及解决方案

Mock 对象未生效： 确保使用了 @MockBean 注解，并且 Mock 对象的行为配置正确。检查是否正确使用了 Mockito.when() 方法，以及参数匹配器是否正确。
NullPointerException： 检查 Mock 对象的返回值是否为空。如果 Mock 对象返回 null，可能会导致 NullPointerException。可以使用 Mockito.when().thenReturn() 方法指定 Mock 对象的返回值。
Mockito.any() 的使用： Mockito.any() 方法是一个强大的参数匹配器，但过度使用可能会降低测试的精确性。尽量使用更具体的参数匹配器，例如 Mockito.eq() 或 Mockito.argThat()。