跨平台开发 / 系统课时
测试异步 Future 逻辑
测试异步 Future 逻辑
本篇解决 Flutter 单元测试中异步代码难以验证的问题,通过正确等待 Future 完成,测试成功返回、异常抛出等不同执行路径。
学习目标
- 掌握 Flutter 测试中等待 Future 的正确方式
- 验证异步业务逻辑的成功和失败结果
- 避免因为未等待异步任务导致测试误判
理解 Future 测试的关键
Flutter 中大量业务逻辑都是异步的,例如网络请求、数据库查询和文件读写。测试异步代码时,测试框架必须知道什么时候等待、什么时候结束,否则可能出现测试提前完成或者异常没有被捕获的问题。
test 函数本身支持异步回调,可以通过 async 和 await 等待 Future 结果。
测试成功返回路径
下面示例测试一个异步用户查询服务。
dart
import 'package:flutter_test/flutter_test.dart';
class UserService {
Future<String> findName(int id) async {
if (id == 1) {
return 'Alice';
}
throw Exception('User not found');
}
}
void main() {
test('returns user name asynchronously', () async {
final service = UserService();
final name = await service.findName(1);
expect(name, 'Alice');
});
}预期输出
text
00:00 +1: returns user name asynchronously
00:00 +1: All tests passed!await 会暂停测试函数执行,直到 Future 完成。只有拿到最终结果后,断言才有意义。
测试异常路径
异步业务不仅需要验证成功,也需要确认错误处理符合预期。
dart
import 'package:flutter_test/flutter_test.dart';
Future<void> loadData() async {
throw Exception('network error');
}
void main() {
test('throws error when request fails', () async {
expect(
() async => await loadData(),
throwsException,
);
});
}预期输出
text
00:00 +1: throws error when request fails
00:00 +1: All tests passed!throwsException 用于验证 Future 最终是否以异常结束。如果只调用方法但没有等待,异常可能不会被测试框架捕获。
测试异步代码的常见错误
常见问题包括:
- 忘记给测试函数添加
async - 忘记使用
await获取 Future 结果 - 使用固定延迟等待异步完成
- 只测试成功路径,不测试异常路径
例如不要使用:
dart
await Future.delayed(Duration(seconds: 1));等待异步任务完成。固定时间依赖运行环境,机器性能变化会导致测试不稳定。
验证异步状态变化
对于状态管理或 Repository 场景,通常需要等待状态更新完成后再断言。例如先触发加载操作,再等待 Future 完成,最后检查状态。
异步测试的核心原则是:让测试等待真实完成条件,而不是猜测需要等待多久。这样测试才能在本地、持续集成环境中保持一致结果。
按自己的节奏,确认真正理解。