文章顶部.png

乌冬.png

1 前言

从最初的探索，再到现在的团队成员共同完善 Flutter 单元测试，期间踩了不少坑也积累了不少经验，现将这些内容分享出来，希望能给对 Flutter 单元测试感兴趣的同学带来一些帮助。

2 背景

我们团队使用一套代码维护了多个 App，这种方式带来了很多好处，但也有一些不足之处，例如代码改动会影响多个 App，影响面评估难度，容易引起线上问题，回归工作量大。我们的 App 使用 Flutter 开发，Flutter 升级迭代速度快，这也会导致回归工作量也大。此外，好的代码是重构出来的，所以需要持续进行重构，但没有充足的测试保障，重构便多了很多顾虑。为了解决这些问题，我们决定完善单元测试，让单元测试减轻测试工作量，同时提供更多的保障。

3 实践历程

3.1 前期准备

3.1.1 Flutter 单元测试入门

虽然大家对单元测试并不陌生，但对如何在 Flutter 上实现单元测试其实还不是很了解，所以首要任务是让团队内的同学都了解 Flutter 单元测试是什么，该怎么做。为此我们确定了一位同学进行前期的探索，然后拿一个业务模块进行尝试，并在尝试之后整理和分享了入门相关的知识。

3.1.2 单元测试工具

项目的代码已经进行组件化，现有的组件比较多，如果一个个运行单元测试和查看结果会耗费很多人力，为此我们实现了一个单元测试工具。在初期支持了组件单元测试批量运行，并在结束之后生成单元测试报告，在报告中可查看组件信息和单元测试覆盖率。该测试工具结合 Jenkins 的定时任务便可每天自动运行所有组件的单元测试，并可统一查看运行结果。

3.2 覆盖率提升

入门了，工具也有了，那么接下来就是完善组件的单元测试了。

3.2.1 提升计划

完善单元测试需要对功能和代码逻辑都有一定了解，因此单元测试便由该组件的负责人进行完善。由于是首次进行完善，不确定性较高，因此没有把目标定的太高，决定在 3 个月内将所有组件的覆盖率提高到 50%。

3.2.2 问题解决

3.2.2.1 问题文档共建

实践过程中遇到了各种各样的问题，解决起来很费时间，为了避免重复踩坑，共建了常见问题及解决方案的文档。

3.2.2.2 覆盖率统计准确性提升

由于制定的目标涉及到了覆盖率，因此对覆盖率的统计准确性很重要，实践过程中发现 flutter test 对覆盖率统计存在以下问题：

文件未导入时不会被统计：组件内的文件如果没被直接或者间接 import，那么就不会有该文件的覆盖率，因此导致漏统计；
文件无法单元测影响覆盖率：有一些文件可能涉及到文件操作之类，无法进行单元测试，这部分文件被统计进去会拉低覆盖率。针对这两类问题，我们在单元测试工具中新增了自动导入和文件过滤功能，用以提升覆盖率统计的准确性。

3.2.3 结果复盘

为了了解完成情况，每半个月进行了一次统计，统计的数据为每个人所负责的组件的覆盖率的平均值，并根据阶段设置了目标覆盖率，统计结果如下：

从上面的统计结果可以看出，虽然最后大部分同学的覆盖率都达到了 50% 以上，但是有部分同学是集中在最后一段时间完成的。

对此大家的第一反应可能是效率真高，但事实情况真是如此吗？有人对此提出了质疑，所以对部分组件的单元测试代码进行了抽查，抽查后确实发现了一些问题：

针对某个页面的单元测试只是把页面打开了，并未进行任何的验证；
很多的单元测试用例并未通过。上述的场景单看覆盖率是没有问题的，但这样的单元测试其实是没有意义的，完全是为了覆盖率而写单元测试。

3.3 有效的单元测试

基于上次的失败实践经历，组内进行了反思和讨论，最终希望通过下面这些措施保证写出有效的单元测试。

3.3.1 如何写出有效的单元测试分享

要写出有效的单元测试，那么就需要先明白什么样的单元测试才是有效的。为此我们基于《如何写出有效的单元测试》这篇文章的内容进行了组内分享，让大家对有效有了个共同的认知。

3.3.2 通过率查看和通知

由于之前的单元测试报告只体现了覆盖率，因此让不通过的单元测试有机可乘，所以也对单元测试工具进行了改进，新增了通过率以及日志查看功能，如下：

另外，对于通过率和覆盖率不达标的组件会在群里通知该组件的负责人，如下：

3.3.3 按照用例完善单元测试

之前并未对单元测试用例进行限制，是让大家自有发挥的，因此才出现了没有验证逻辑的单元测试代码。为了避免再出现这种问题，对如何写单元测试制定了标准，就是需要按照测试用例写单元测试代码。

按照这个标准去执行的话，可能会遇到这些问题：

非业务组件没有测试用例怎么办？
测试没有时间整理测试用例怎么办？对于此类问题，我们的解决方案是自己动手丰衣足食。当然我们写的测试用例也需要是有效的，因此在组内也分享了如何写测试用例，另外测试同学也会帮忙把把关。

3.3.4 代码验收

上一次的实践只是进行了阶段性的统计，过程中并没有对单元测试进行验收，所以本次实践新增了验证环节，每个月进行一次合并，合并组件的单元测试需满足以下条件：

通过率 100%；
覆盖率 80% 以上；
有单元测试用例；
按照测试用例写单元测试代码，每个用例都有验证逻辑。通过以上的验收保证每一个完成单元测试的组件都能产生它应有的价值，而不是流于形式。

3.4 提效

有效的流程虽然已经摸索出来了，但还有一个困难的问题摆在眼前，那就是完善单元测试很耗费时间，如何进行提效？以下是尝试之后发现的一些可以帮助提高效率的举措：

3.4.1 单元测试组件

单元测试的时候往往需要依赖很多其他组件的初始化操作，特别是业务组件，这部分代码基本上也是相同的，如果每个地方都写一遍不仅费时还很难维护。为此我们创建了一个单元测试的组件，用于进行一些公共的初始化操作等。

3.4.2 代码模版

写单元测试代码的时候会有很多一样的代码，例如使用 pump 进行刷新：

await tester.pump(Duration(milliseconds: 1000));

对于这种出现频率较高的代码，我们创建了代码模板，只需要输入相应的关键词便可快速输入相应的代码，例如上面的代码只需要输入关键词 tpump 即可。

3.4.3 ChatGPT

随着 ChatGPT 的兴起，这种生成式 AI 和单元测试的结合能让我们的效率更高。例如，一般业务组件都会有很多 model 类，这些类基本上都是贫血模型，除了基本的属性之外也就只有支持 Json 双向解析的 fromJson 和 toJson 方法，当属性很多的时候写起单元测试十分煎熬，对此有同学尝试了让 ChatGPT 来帮忙做这件事。实际效果还是很好的，当然也不局限于 model 类，很多公共功能都是可以的。

4 总结

目前虽然还没有完成全部组件的单元测试，但通过这几次的实践已经感受到了单元测试带来的好处，写测试用例加深了对功能的了解，并在写单元测试过程中发现了一些历史遗留 bug。后续我们将持续完善单元测试，并探索更多的提效方式，早日让单元测试带来更多的价值。

由团队共成员同维护的常见问题及解决方案文档的内容也放到了本文最后，希望能给大家带来一些帮助，如果发现了不足或者错误欢迎指正。

5 常见问题及解决方案

5.1 计时器问题

当代码中存在延时操作时（例如 Toast 展示 2 秒后自动消失等），在单元测试时就很容易出现以下错误：

A Timer is still pending even after the widget tree was disposed. 其根本原因是单元测试已经结束，但是计时器还未结束，所以要解决该类问题就是要在单元测试结束之前结束所有计时器，即在单元测试最后一行增加 pump 等待计时器结束，等待的时间与计时器时间相关。

testWidgets('测试', (tester) async {
  /// 测试逻辑...
  
  /// 等待定时器结束
  await tester.pump(Duration(milliseconds: 3000));
});

此外，如果在测试的过程中有延时操作，也需要增加一个 pump 等待计时器结束，否则相应的操作将不生效。例如点击一个按钮，延迟 2 秒后更新页面，此时如果直接刷新页面，由于定时器还未结束并不能得到你想要的结果。

5.2 使用 pumpAndSettle 超时

使用 pumpAndSettle 刷新页面时，经常会出现超时错误，错误信息如下：

pumpAndSettle timed out 首先可以尝试增加时间间隔，默认是 100 毫秒，例如增加到 1000 毫秒：

await tester.pumpAndSettle(Duration(milliseconds: 1000));

如果上述方法依然不能解决问题，可尝试使用两个甚至更多的 pump 进行刷新：

await tester.pump(Duration(milliseconds: 1000));
await tester.pump(Duration(milliseconds: 1000));

5.3 使用 Image.network() 报错

单元测试时，使用 Image.network() 加载网络图片便会出现以下错误：

The following NetworkImageLoadException was thrown resolving an image codec: HTTP request failed, statusCode: 400 要解决该问题，需要在 pubspec.yaml 的 dev_dependencies 中添加 mocktail_image_network 依赖：

dev_dependencies:
  mocktail_image_network: 0.2.0

在测试用例代码前后添加 mockNetworkImages：

testWidgets('mockNetworkImages', (tester) async {
  await mockNetworkImages(() async {
    /// 测试代码
  });
});

5.4 使用 MethodChannel 报错

单元测试时，如果通过 MethodChannel 调用了原生方法便会出现以下错误：

MissingPluginException(No implementation found for method xxx on channel xxx) 针对此问题，flutter_test 提供了 Mock 的解决方案，即通过 setMockMethodCallHandler 设置处理方法，setMockMethodCallHandler 的使用方法如下：

const channel = MethodChannel('name');
channel.setMockMethodCallHandler((MethodCall methodCall) async {
  if (methodCall.method == 'method') {
    return 'result';
  }
});

5.5 使用 RichText 时查找不到文本

使用 text、textContaining 查找文本时将 findRichText 设置为 true（默认是关闭的），如下：

expect(find.text('文本', findRichText: true), findsOneWidget);
expect(find.textContaining('文本', findRichText: true), findsOneWidget);

5.6 点击事件没反应

可以用以下方式解决：

var icon = find.widgetWithIcon(GestureDetector, Icons.more);
GestureDetector gestureDetector = icon.evaluate().first.widget;
gestureDetector.onTap();

5.7 Widget 已显示但是找不到

确认下 Widget 是否在屏幕上已可见，如果在下面需要对页面进行滑动操作，让其显示在屏幕中才能查找到。

5.8 空安全报错

针对空安全适配的组件，因为依赖的组件没有完全适配空安全，导致单测失败，需要在 test 文件上方加上：

// @dart=2.9

5.9 Map 自动推导类型出错

写单元测试用例过程中，经常需要 Mock 接口返回的数据，一般的做法就是通过抓包把接口返回的 Json 格式数据拷贝过来。

实际操作过程中遇到了一个很奇葩的问题，在此也分享给大家，以免掉坑。

问题描述

如 Mock 一个 models 属性为：

"models": {
  "showSkeleton": true,
}

数据结构中声明的是：Map<String, dynamic>? models。通过 models = json['models'] 赋值以后，使用过程中往 models 加 value 为 String 的类型会报错。

问题原因

Map 会进行数据类型推导，如上述例子被自动推导为 <String, bool>。

解决方案

Mock 时强制声明一下类型：

"models": <String, dynamic>{
  "showSkeleton": true,
}

5.10 Undefined name 'main'

写单元测试用例过程中需要添加一些辅助的文件，这些文件往往会被习惯性命名成 xxx_test.dart 那么这时候就会出现这个错误。

因为以 _test 结尾，所以这个文件被误认为是单元测试用例的文件，要解决这个问题只需将 _test 去掉即可。

5.11 没有生成 coverage/html 文件

genhtml: ERROR: no valid records found in tracefile coverage/ lcov.info 检查当前单测执行文件目录是否正确，需要进入根目录，而不是 test 目录。

5.12 覆盖率报告没有相关文件

首先检查单元测试用例能否运行通过，运行失败有可能会导致报告数据异常。

如果能运行通过，检查缺少的文件在单元测试中是否被直接或者间接 import，如果一个文件没有被直接或者间接 import，那么该文件将不会被统计。

5.13 写了单元测试用例但是没有覆盖率

与没有相关文件一样，首先检查单元测试用例能否运行通过，然后检查下单元测试用例文件是否以 _test 结尾，如果没有那么该文件中的用例将不会被运行。

招贤纳士

政采云技术团队（Zero），Base 杭州，一个富有激情和技术匠心精神的成长型团队。规模 500 人左右，在日常业务开发之外，还分别在云原生、区块链、人工智能、低代码平台、中间件、大数据、物料体系、工程平台、性能体验、可视化等领域进行技术探索和实践，推动并落地了一系列的内部技术产品，持续探索技术的新边界。此外，团队还纷纷投身社区建设，目前已经是 google flutter、scikit-learn、Apache Dubbo、Apache Rocketmq、Apache Pulsar、CNCF Dapr、Apache DolphinScheduler、alibaba Seata 等众多优秀开源社区的贡献者。

如果你想改变一直被事折腾，希望开始折腾事；如果你想改变一直被告诫需要多些想法，却无从破局；如果你想改变你有能力去做成那个结果，却不需要你；如果你想改变你想做成的事需要一个团队去支撑，但没你带人的位置；如果你想改变本来悟性不错，但总是有那一层窗户纸的模糊……如果你相信相信的力量，相信平凡人能成就非凡事，相信能遇到更好的自己。如果你希望参与到随着业务腾飞的过程，亲手推动一个有着深入的业务理解、完善的技术体系、技术创造价值、影响力外溢的技术团队的成长过程，我觉得我们该聊聊。任何时间，等着你写点什么，发给 zcy-tc@cai-inc.com

微信公众号

文章同步发布，政采云技术团队公众号，欢迎关注