跨平台开发 / 系统课时

避免过度 Mock 绑死实现细节

避免过度 Mock 绑死实现细节

Mock 能隔离外部依赖,但把每个内部对象都替换成 Mock,再逐条验证调用顺序,会让测试跟着实现结构一起变化。本节通过一个订单状态更新示例,识别这类脆弱断言,并把测试重心移回最终可观察行为和真正稳定的协作边界。

学习目标

  • 识别过度 Mock 和过度交互验证的典型信号
  • 用 Fake 或内存实现验证最终可观察状态
  • 只在副作用边界保留必要的 Mock 断言

脆弱测试通常在验证实现过程

下面是一个片段示例,假设 repository、validator 和 audit 都是已经创建并完成桩配置的 Mock。它验证了当前实现的内部调用顺序,但这些步骤并不一定属于业务对外承诺。

dart
// 片段示例:依赖已创建并完成 stub,仅展示脆弱的交互断言。
verifyInOrder([
  () => repository.findById(7),
  () => validator.validate(any()),
  () => repository.save(any()),
  () => audit.record('order-paid'),
]);

如果把校验移动到实体内部、合并仓储方法,或调整审计记录时机,即使“订单最终变为已支付”完全没变,这个测试也会失败。此时失败告诉你的只是实现结构变化,而不是业务行为回归。

用 Fake 观察稳定结果

对于仓储这类可以轻量内存实现的依赖,Fake 往往比 Mock 更适合行为测试。下面的完整示例不关心服务内部先调用哪个方法,只验证执行后仓储中的订单状态。

dart
import 'package:test/test.dart';

enum OrderStatus { pending, paid }

class Order {
  const Order({
    required this.id,
    required this.status,
  });

  final int id;
  final OrderStatus status;

  Order copyWith({OrderStatus? status}) {
    return Order(
      id: id,
      status: status ?? this.status,
    );
  }
}

abstract interface class OrderRepository {
  Order? findById(int id);
  void save(Order order);
}

class InMemoryOrderRepository implements OrderRepository {
  InMemoryOrderRepository(Iterable<Order> initial)
      : _items = {for (final order in initial) order.id: order};

  final Map<int, Order> _items;

  @override
  Order? findById(int id) => _items[id];

  @override
  void save(Order order) {
    _items[order.id] = order;
  }
}

class OrderService {
  OrderService(this.repository);

  final OrderRepository repository;

  void markPaid(int orderId) {
    final order = repository.findById(orderId);
    if (order == null) {
      throw StateError('Order not found: $orderId');
    }

    repository.save(order.copyWith(status: OrderStatus.paid));
  }
}

void main() {
  test('标记支付后可以从仓储观察到 paid 状态', () {
    final repository = InMemoryOrderRepository([
      const Order(id: 7, status: OrderStatus.pending),
    ]);
    final service = OrderService(repository);

    service.markPaid(7);

    expect(repository.findById(7)?.status, OrderStatus.paid);
  });
}

预期结果:无论 OrderService 内部如何拆分校验或重构辅助方法,只要最终通过仓储边界观察到订单为 paid,测试就继续通过。

保存为 test/order_service_test.dart 后执行:

bash
dart test test/order_service_test.dart --reporter expanded

预期输出:

text
<TIME> +0: loading test/order_service_test.dart
<TIME> +0: 标记支付后可以从仓储观察到 paid 状态
<TIME> +1: All tests passed!

<TIME> 为运行时耗时,实际值可能不同。

哪些边界仍然适合 Mock

减少 Mock 不等于完全不用 Mock。真正需要确认“某个副作用是否发生”的边界仍适合交互验证,例如支付网关只能扣款一次、邮件网关不得在校验失败时发送、消息发布器必须携带正确业务 ID。

判断时可以问:如果把内部实现全部重写,只要这个交互消失或重复,业务是否就真的错了? 如果答案是肯定的,Mock 验证通常有价值;如果只是某个私有步骤、调用顺序或辅助对象发生变化,则更适合通过结果断言覆盖。

发现过度 Mock 的信号

常见信号包括:一个简单场景要创建很多 Mock;测试大量使用 verifyInOrder 或 verifyNoMoreInteractions;改名、拆方法或合并组件就触发失败;断言数量主要描述“怎么做”,而不是“产生了什么结果”。

修正时先保留输入和可观察结果,再删除没有业务意义的交互断言。对于纯计算直接断言返回值,对于状态变更使用 Fake 或内存仓储,对于不可逆副作用才保留最小必要的 Mock。这样测试既能发现真实回归,也给实现保留合理的重构空间。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

避免过度 Mock 绑死实现细节

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通