本文深入探讨了在spring boot服务层测试中，如何正确模拟（mock）数据访问对象（dao）或其他服务中的模型参数。通过分析常见错误——即使用`new object()`创建的参数无法匹配到模拟方法——文章详细介绍了如何利用mockito的`mockito.any()`方法来解决这一问题，确保模拟行为能够被正确触发，从而编写出更健壮、更有效的单元测试。
服务层测试与依赖模拟
在现代应用开发中，服务层（Service Layer）承载着业务逻辑的核心。为了确保业务逻辑的正确性，对服务层进行单元测试至关重要。然而，服务层通常会依赖于数据访问对象（DAO）或其他的服务。在测试服务层时，我们不希望这些外部依赖的实际行为影响测试结果，而是希望它们返回预设的数据，这就是“模拟”（Mocking）的用武之地。
以一个管理学生分数的ExamServiceImpl为例：
@Service
public class ExamServiceImpl implements ExamService {
private final SubjectService subjectService; // 假设原问题中是scoreService，这里修正为更语义化的subjectService
private final ScoreDAO scoreDAO;
@Autowired
public ExamServiceImpl(SubjectService subjectService, ScoreDAO scoreDAO) { // 修正构造函数注入
this.subjectService = subjectService;
this.scoreDAO = scoreDAO;
}
@Override
public ResponseModel insertScore(RequestModel request) throws IOException {
SubjectModel subject = subjectService.getNameSubject(request); // 从SubjectService获取科目信息
ScoreModel score = new ScoreModel();
score.setStudentName(request.getStudentName()); // 假设RequestModel有getStudentName方法
score.setScore(request.getStudentScore()); // 假设RequestModel有getStudentScore方法
score.setSubject(subject.getSubject()); // 假设SubjectModel有getSubject方法
int result = scoreDAO.insert(score); // 插入分数到数据库
// 假设ResponseModel是一个简单的封装，这里直接返回结果
return new ResponseModel(result == 1 ? "Success" : "Failed");
}
}为了测试insertScore方法，我们需要模拟SubjectService和ScoreDAO的行为。
常见的模拟陷阱：对象实例不匹配
许多开发者在初次尝试模拟时，会遇到模拟方法未按预期执行的问题。例如，以下测试代码尝试模拟ScoreDAO的insert方法：
@SpringBootTest
public class ExamServiceImplTest {
@MockBean
private ScoreDAO scoreDAO;
@MockBean // 使用@MockBean来模拟Spring管理的Bean
private SubjectService subjectService;
@Autowired
private ExamService examService;
@Test
void insertScoreTest() throws IOException {
// 1. 模拟 SubjectService
SubjectModel resFromSubject = new SubjectModel();
resFromSubject.setSubject("Math");
Mockito.when(subjectService.getNameSubject(Mockito.any(RequestModel.class))).thenReturn(resFromSubject);
// 2. 尝试模拟 ScoreDAO - 错误示范
// Mockito.when(scoreDAO.insert(new ScoreModel())).thenReturn(1); // 这里的new ScoreModel()是问题所在
// 3. 执行待测试方法
RequestModel request = new RequestModel(); // 假设请求模型
request.setStudentName("John Doe");
request.setStudentScore(90);
ResponseModel response = examService.insertScore(request);
// 4. 断言
// Assertions.assertEquals("Success", response.getMessage()); // 假设ResponseModel有getMessage方法
// 如果上面mock失败，这里的response会是Failed
}
}在上述代码中，Mockito.when(scoreDAO.insert(new ScoreModel())).thenReturn(1); 这行代码通常不会生效。原因在于，new ScoreModel()在Mockito.when()中创建了一个新的ScoreModel实例，而ExamServiceImpl内部在执行scoreDAO.insert(score)时，又创建了另一个ScoreModel实例。这两个实例在内存中是不同的对象，即使它们的内容可能相同，Mockito默认是基于对象引用进行匹配的。因此，scoreDAO.insert()方法接收到的实际参数与when()中指定的参数不匹配，导致模拟行为没有被触发，scoreDAO.insert()最终返回其默认值（对于int类型是0）。
解决方案：使用Mockito.any()进行参数匹配
为了解决对象实例不匹配的问题，Mockito提供了参数匹配器（Argument Matchers），其中最常用的是Mockito.any()。Mockito.any()允许我们指定一个类型，表示“任何该类型的对象”都可以匹配。
将错误的模拟语句修正为：
Mockito.when(scoreDAO.insert(Mockito.any(ScoreModel.class))).thenReturn(1);
这行代码的含义是：当scoreDAO的insert方法被调用，并且传入的参数是任何ScoreModel类型的实例时，都返回1。这样，无论ExamServiceImpl内部创建的ScoreModel实例是什么，只要它是ScoreModel类型，模拟行为就会被正确触发。
完整的修正后的测试代码
结合上述修正，完整的ExamServiceImplTest应如下所示：
package com.example.service; // 假设的包名
import com.example.dao.ScoreDAO;
import com.example.model.RequestModel;
import com.example.model.ResponseModel;
import com.example.model.ScoreModel;
import com.example.model.SubjectModel;
import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.Test;
import org.mockito.Mockito;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.test.mock.mockito.MockBean;
import java.io.IOException;
@SpringBootTest // 适用于集成测试，会加载Spring上下文
public class ExamServiceImplTest {
// 使用 @MockBean 来模拟 Spring 上下文中的 Bean
@MockBean
private ScoreDAO scoreDAO;
@MockBean
private SubjectService subjectService; // 修正为SubjectService
// 自动注入待测试的服务
@Autowired
private ExamService examService;
@Test
void insertScoreTest() throws IOException {
// 1. 准备模拟数据
SubjectModel resFromSubject = new SubjectModel();
resFromSubject.setSubject("Math");
// 2. 模拟 SubjectService 的行为
// 当 subjectService.getNameSubject() 接收到任何 RequestModel 实例时，返回预设的 SubjectModel
Mockito.when(subjectService.getNameSubject(Mockito.any(RequestModel.class)))
.thenReturn(resFromSubject);
// 3. 模拟 ScoreDAO 的行为
// 当 scoreDAO.insert() 接收到任何 ScoreModel 实例时，返回 1
Mockito.when(scoreDAO.insert(Mockito.any(ScoreModel.class)))
.thenReturn(1);
// 4. 准备测试请求
RequestModel request = new RequestModel();
request.setStudentName("John Doe");
request.setStudentScore(90);
// 5. 执行待测试方法
ResponseModel response = examService.insertScore(request);
// 6. 断言结果
Assertions.assertNotNull(response);
Assertions.assertEquals("Success", response.getMessage()); // 假设ResponseModel有getMessage方法
// 7. 验证模拟方法是否被调用 (可选但推荐)
// 验证 subjectService.getNameSubject() 被调用了一次，且参数是 RequestModel 类型
Mockito.verify(subjectService, Mockito.times(1))
.getNameSubject(Mockito.any(RequestModel.class));
// 验证 scoreDAO.insert() 被调用了一次，且参数是 ScoreModel 类型
Mockito.verify(scoreDAO, Mockito.times(1))
.insert(Mockito.any(ScoreModel.class));
}
}注意事项：@MockBean vs @Mock / @InjectMocks
在原问题中，提到了两种测试设置方式：
- @SpringBootTest + @MockBean: 这种方式适用于集成测试，它会启动一个简化的Spring应用上下文。@MockBean会将Spring容器中对应的Bean替换为Mockito模拟对象。这是测试服务层依赖于Spring上下文（如事务管理、其他Spring Bean）时的推荐方式。
- @RunWith(MockitoJUnitRunner.class) / @ExtendWith(MockitoExtension.class) + @Mock + @InjectMocks: 这种方式适用于纯粹的单元测试，不启动Spring上下文。@Mock用于创建模拟对象，@InjectMocks用于将模拟对象注入到待测试对象中。这种方式启动更快，但不能测试Spring上下文相关的行为。
无论采用哪种方式，Mockito.any()的用法都是相同的，它解决的是Mockito参数匹配的核心问题。本教程主要侧重于@SpringBootTest环境下的解决方案，因为它在实际项目中更为常见。
总结与最佳实践
正确地模拟依赖是编写高效、可靠单元测试的关键。当你在模拟方法时，如果发现模拟行为没有被触发，首先应该检查你是否正确地匹配了参数。
关键点回顾：
- 对象实例匹配： Mockito默认通过对象引用进行参数匹配。new Object()在when()中与在实际调用中创建的new Object()是不同的实例。
- 使用Mockito.any()： 这是解决对象实例不匹配问题的最常用方法。它允许你的模拟匹配任何给定类型的对象。
- 参数匹配器的组合： 如果你需要匹配多个参数，并且其中一些需要精确匹配，另一些需要模糊匹配，可以组合使用Mockito.any()和Mockito.eq()等匹配器。但请注意，一旦使用了一个参数匹配器，所有参数都必须使用匹配器。
- 验证（Mockito.verify()）： 在测试结束时，使用Mockito.verify()来验证模拟对象的方法是否被调用，以及调用次数和传入的参数是否符合预期，这有助于确保业务逻辑的正确性。
通过掌握Mockito.any()等参数匹配器的使用，你将能够更有效地编写服务层测试，确保你的业务逻辑在隔离的环境中被充分验证。
