跨平台开发 / 系统课时

测试异步 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 完成,最后检查状态。

异步测试的核心原则是:让测试等待真实完成条件,而不是猜测需要等待多久。这样测试才能在本地、持续集成环境中保持一致结果。

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

目录与阅读设置

阅读设置

17

记录一个想法

测试异步 Future 逻辑

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

登录哪都通