跨平台开发 / 系统课时

用 Mock 控制依赖返回行为

用 Mock 控制依赖返回行为

复杂协作对象经常包含成功、失败、超时等分支,真实服务很难稳定制造这些条件。Mock 可以在测试里预设返回值或异常,并验证业务代码是否按预期调用依赖,从而精确覆盖协作边界。

学习目标

  • 用 Mock 预设异步依赖的成功结果与失败结果。
  • 验证关键调用的参数和次数,而不过度绑定实现细节。
  • 区分“验证业务结果”和“验证协作行为”两类断言。

Mock 解决的是可控协作

Mock 不需要真正完成支付、发邮件或访问远程接口。测试先声明“当某个方法以某组参数调用时,应返回什么”,业务代码随后照常运行。这样可以稳定进入平时很难复现的分支。

下面示例使用 mocktail。如果项目尚未安装测试依赖,可以先添加 test 和 mocktail。

bash
dart pub add --dev test mocktail

预期结果

text
pubspec.yaml 中出现 test 和 mocktail 开发依赖,命令成功退出;具体解析版本可能不同。

Mock 只替代 PaymentGateway,真正被测试的是 CheckoutService 的业务分支。

预设返回值和异步异常

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

abstract class PaymentGateway {
  Future<String> charge(int cents);
}

class MockPaymentGateway extends Mock implements PaymentGateway {}

class CheckoutService {
  final PaymentGateway gateway;

  CheckoutService(this.gateway);

  Future<String> checkout(int cents) async {
    try {
      final transactionId = await gateway.charge(cents);
      return 'paid:$transactionId';
    } on StateError {
      return 'retry';
    }
  }
}

void main() {
  late MockPaymentGateway gateway;
  late CheckoutService service;

  setUp(() {
    gateway = MockPaymentGateway();
    service = CheckoutService(gateway);
  });

  test('returns transaction id when payment succeeds', () async {
    when(() => gateway.charge(5000))
        .thenAnswer((_) async => 'tx-1');

    final result = await service.checkout(5000);

    expect(result, 'paid:tx-1');
    verify(() => gateway.charge(5000)).called(1);
  });

  test('returns retry when gateway fails', () async {
    when(() => gateway.charge(5000)).thenAnswer(
      (_) => Future<String>.error(
        StateError('gateway unavailable'),
      ),
    );

    final result = await service.checkout(5000);

    expect(result, 'retry');
  });
}

预期输出

text
<TIME> +2: All tests passed!

实际时间值可能不同。第一条测试预设支付成功,并验证网关只被调用一次;第二条测试让返回的 Future 失败,因此可以稳定验证业务层的异常处理。

为什么异步失败要模拟 Future 失败

charge 的契约是返回 Future<String>。如果生产环境中的错误来自异步请求失败,那么测试也应尽量保持相同的异步边界。使用 Future<String>.error(...) 能让异常在 await 时出现,更贴近 HTTP 请求或异步 SDK 调用。

如果依赖的方法本来就是同步方法,则可以配置同步抛错。测试替身应匹配接口契约,而不是为了写法简短改变错误发生的时机。

验证关键协作,不要验证每一步

verify 适合确认真正属于业务规则的协作,例如“扣款只能执行一次”或“失败后不能继续提交订单”。但如果把每个 getter、日志调用和中间方法都验证一遍,重构内部实现时会产生大量无意义失败。

更稳妥的顺序是先断言业务结果,再只验证少数关键交互。这样测试既能发现行为回归,也不会把实现细节锁死。

每个测试重新创建 Mock 同样重要。若多个测试共享一个已经配置的 Mock,旧的 stub 或调用记录可能干扰后续断言。通过 setUp 创建新实例,可以让每个测试从干净状态开始。

Mock 最适合复杂协作边界:需要精确制造成功、失败或特殊返回值,并关心关键调用是否发生。若依赖只是简单内存读写,Fake 往往更自然;若要确认真实 SDK、网络或数据库契约,则还应补充集成测试。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Mock 控制依赖返回行为

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

登录哪都通