Java/Spring中测试Mockito Spy教程
内容提要
Mockito是一个强大的模拟框架，可以用于单元测试。它的Spy功能可以包装真实对象，允许大多数操作照常执行，并提供拦截和更改特定方法调用的能力。Spy特别适用于处理遗留代码和复杂系统。使用Mockito Spy需要正确设置Java项目环境，并遵循最佳实践和避免常见陷阱。Mockito Spy与Spring框架集成可以提供更强大的测试功能。
延伸解读
Spy 与 Mock 的核心区别
Mockito 的 Spy 和 Mock 是两种不同的测试替身。Mock 是完全模拟的对象，不保留真实行为，适用于隔离外部依赖或测试交互；而 Spy 包装真实对象，默认调用真实方法，仅对特定方法进行存根或验证。选择时需考虑：若需要真实行为的大部分逻辑，仅覆盖少数方法，Spy 更合适；若需完全控制对象行为，Mock 更简单。
Spy 在遗留代码测试中的价值
遗留代码通常难以重构，且依赖复杂。Spy 允许保留对象的真实行为，仅覆盖难以测试的部分（如外部调用），从而避免大规模修改代码。例如，可以存根外部服务调用，使测试不依赖外部环境，提高可靠性和速度。但需注意，过度使用 Spy 可能掩盖设计问题，应谨慎使用。
Spring 集成中的 @SpyBean 使用要点
在 Spring 测试中，@SpyBean 可以部分模拟 Spring bean，保留依赖注入和上下文。与 @SpringBootTest 结合，能测试真实 bean 的行为，同时存根特定方法。例如，存根 EmailService 的方法以避免外部调用。这提高了测试的集成度和灵活性，但需确保存根行为明确，避免不必要的存根导致测试脆弱。
使用 Spy 的最佳实践与常见陷阱
最佳实践包括：谨慎使用 Spy，优先考虑标准 Mock；明确定义存根，避免过度存根；精确验证，聚焦测试目标；保持测试单一职责。常见陷阱有：过度使用 Spy 导致测试复杂；存根所有方法违背 Spy 初衷；忽略默认真实行为引发意外副作用；测试间未隔离状态。遵循这些原则可提升测试可维护性。
Q&A
Mockito Spy 和普通的 Mock 有什么区别？
Mockito Spy 是部分模拟对象，它包装真实对象，默认调用真实方法，除非显式存根；而普通 Mock 是完全模拟对象，不保留真实行为，所有方法默认返回默认值。Spy 适用于需要真实行为但想覆盖特定方法的场景，Mock 适用于完全隔离和模拟交互的场景。
在 Spring 项目中如何使用 Mockito Spy 来测试一个 Service？
在 Spring 项目中，可以使用 @SpyBean 注解将 Spy 注入到 Spring 上下文中。例如，在测试类上使用 @SpringBootTest，并用 @SpyBean 标注要监视的 Service 字段。这样，Service 的真实方法会被调用，除非你用 Mockito.doReturn(...).when(spy).method(...) 存根特定方法。
使用 Mockito Spy 时有哪些常见陷阱需要避免？
常见陷阱包括：过度使用 Spy 导致测试复杂且难以维护；存根所有方法，违背 Spy 的初衷；忽略 Spy 默认调用真实方法的行为，导致意外副作用；以及测试之间不隔离，依赖其他测试的状态。
Mockito Spy 在处理遗留代码时有什么优势？
对于遗留代码，完全模拟可能不切实际，因为真实对象行为复杂且难以复制。Spy 允许保留对象的大部分真实行为，仅覆盖难以测试的特定部分（如外部依赖），从而在不重构代码的情况下进行有效测试。
如何用 Mockito Spy 编写一个简单的单元测试？
编写测试的三个关键步骤是：1. 创建 Spy：使用 Mockito.spy(realObject) 包装真实对象；2. 验证交互：使用 Mockito.verify(spy).method(args) 验证方法调用；3. 存根方法：使用 Mockito.doReturn(value).when(spy).method(args) 改变特定方法的行为。
在 Maven 项目中如何添加 Mockito 依赖以使用 Spy？
在 Maven 项目的 pom.xml 中添加依赖：<dependency><groupId>org.mockito</groupId><artifactId>mockito-core</artifactId><version>5.10.0</version><scope>test</scope></dependency>。对于 Spring 集成，还需添加 spring-boot-starter-test 依赖。
