在Java开发中，单元测试是保障代码质量的重要手段。然而，当一个类中的某个方法调用了另一个私有或包级访问权限的内部方法时，如何进行有效测试就成了开发者常遇到的难题。传统的Mockito mock对象会完全替代目标行为，无法保留原有逻辑，而这时，Mockito.spy() 提供了一种优雅的解决方案——对真实对象进行“间谍式”监控，在保留原有实现的基础上，精准控制特定方法的行为。

假设我们有一个订单服务类 OrderService，其中包含一个公共方法 processOrder()，该方法内部调用了私有方法 validateOrder() 和 sendNotification()。由于Java语言限制，我们无法直接在测试中调用这些私有方法，也无法通过mock方式模拟它们的行为而不影响其他逻辑。此时，使用 Mockito.spy() 就显得尤为关键。

java
public class OrderService {
public boolean processOrder(Order order) {
if (!validateOrder(order)) {
return false;
}
boolean result = saveToDatabase(order);
if (result) {
sendNotification(order);
}
return result;
}

private boolean validateOrder(Order order) {
    return order != null && order.getAmount() > 0;
}

private void sendNotification(Order order) {
    // 发送邮件或消息通知
    System.out.println("通知已发送给用户：" + order.getUserId());
}

private boolean saveToDatabase(Order order) {
    // 模拟数据库操作
    return true;
}

}

如果我们想测试 processOrder() 方法，并验证 sendNotification() 是否被正确调用，同时又希望 validateOrder() 返回 true 以让流程继续，传统方式很难做到。但借助 Mockito.spy()，我们可以创建一个真实对象的“间谍”，仅对需要控制的方法打桩（stub），其余方法仍执行原始逻辑。

在JUnit测试中，我们可以这样编写：

java
@Test
public void shouldSendNotificationWhenOrderIsValid() {
// 创建被测对象的spy实例
OrderService orderServiceSpy = Mockito.spy(new OrderService());

Order order = new Order();
order.setUserId("user123");
order.setAmount(100);

// 对私有方法无法直接mock？其实可以通过反射+spy结合的方式绕过
// 但更常见的是将私有方法提取为protected或包级方法便于测试
// 这里假设validateOrder已被改为protected以便spy生效

// 打桩验证逻辑始终通过
Mockito.doReturn(true).when(orderServiceSpy).validateOrder(Mockito.any(Order.class));

// 调用待测方法
boolean result = orderServiceSpy.processOrder(order);

// 验证结果和行为
assertTrue(result);
Mockito.verify(orderServiceSpy).sendNotification(order);

}

可以看到，Mockito.spy() 创建的对象本质上是一个增强版的真实对象。它默认调用原方法的实现，但我们可以通过 doReturn().when() 语法对某些方法进行打桩，尤其是那些依赖外部资源或难以构造输入条件的内部方法。这种方式特别适用于以下场景：

• 被测方法链路长，涉及多个内部调用；
• 某些内部方法涉及耗时操作（如网络请求、文件读写），需要隔离；
• 希望验证某个内部方法是否被调用，以及调用次数和参数。

需要注意的是，spy 并非万能。过度使用可能导致测试耦合度过高，破坏了“黑盒测试”的原则。此外，对final类、static方法或private方法的spy支持有限，通常建议配合良好的设计原则，如依赖注入、接口抽象等，来提升可测性。

还有一点容易被忽视：使用 spy 时要小心“部分mock”带来的副作用。例如，如果忘记打桩某个关键方法，可能会意外触发真实逻辑，导致测试不稳定。因此，推荐在打桩后明确使用 verify() 验证交互行为，确保预期路径被执行。

总之，Mockito.spy() 是处理复杂内部调用场景下不可或缺的工具。它让我们既能保持业务逻辑的真实性，又能灵活控制测试边界，从而写出更精准、更可靠的单元测试。在实际项目中，合理运用 spy，结合良好的代码结构与测试策略，才能真正实现高效、可持续的测试覆盖。