跨平台开发 / 系统课时
用 Mock 控制依赖返回行为
用 Mock 控制依赖返回行为
复杂协作对象经常包含成功、失败、超时等分支,真实服务很难稳定制造这些条件。Mock 可以在测试里预设返回值或异常,并验证业务代码是否按预期调用依赖,从而精确覆盖协作边界。
学习目标
- 用 Mock 预设异步依赖的成功结果与失败结果。
- 验证关键调用的参数和次数,而不过度绑定实现细节。
- 区分“验证业务结果”和“验证协作行为”两类断言。
Mock 解决的是可控协作
Mock 不需要真正完成支付、发邮件或访问远程接口。测试先声明“当某个方法以某组参数调用时,应返回什么”,业务代码随后照常运行。这样可以稳定进入平时很难复现的分支。
下面示例使用 mocktail。如果项目尚未安装测试依赖,可以先添加 test 和 mocktail。
dart pub add --dev test mocktail预期结果
pubspec.yaml 中出现 test 和 mocktail 开发依赖,命令成功退出;具体解析版本可能不同。Mock 只替代 PaymentGateway,真正被测试的是 CheckoutService 的业务分支。
预设返回值和异步异常
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');
});
}预期输出
<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、网络或数据库契约,则还应补充集成测试。