Flutter Integration Test偶发无日志卡顿问题排查求助

我们团队正在开发大型项目，当前自动化测试环节遇阻：搭建的Flutter Integration Test在模拟器/仿真器运行时，会出现无日志的偶发性卡顿，有时又能正常执行。现附上通用测试代码示例，想确认是实现错误还是Flutter集成测试本身特性：

import 'package:flutter_test/flutter_test.dart';
import 'package:integration_test/integration_test.dart';

void main() {
  IntegrationTestWidgetsFlutterBinding.ensureInitialized();

  setUpAll(
    () {},
  );
  tearDownAll(
    () async {},
  );
  group('end-to-end test', () {
    testWidgets('Check route based on session', (tester) async {
      
      await tester.runAsync(() async {
        await app.main();
        await tester.pumpAndSettle();
        // We tried to fix stuck bug by waiting 3 secs, it didn't work.
        await tester.pump(const Duration(seconds: 3));
      });

      var jwt = await secureStorage().read(key: "token");

      logIt().d(jwt);

      // if jwt is null there should be a splashpage if not null splashpage should not be there
      expect(find.byType(SplashPage, skipOffstage: false),
          jwt == null ? findsOneWidget : findsNothing);
    });
  });
}

问题分析与修复方案 #

1. tester.runAsync的错误使用 #

将app.main()嵌套在tester.runAsync中是不合理的。runAsync设计用于包裹测试过程中需要异步执行的业务逻辑片段，而启动应用的main()应该直接在测试方法外层调用。这种嵌套会导致测试绑定无法正确跟踪应用生命周期，是引发偶发性卡顿的核心原因之一。

修复方式：移除runAsync包裹，直接调用app.main()。

2. 异步等待逻辑冗余且不可靠 #

• pumpAndSettle()已经会等待所有帧渲染完成、异步任务执行结束，额外添加的固定时长pump完全无效，反而可能干扰测试时序。
• 虽然secureStorage().read用了await，但结合前面的runAsync嵌套，可能出现时序混乱，导致断言执行时机错误。

3. 日志输出时机不当 #

卡顿发生时日志无法打印，是因为测试绑定可能因线程阻塞或生命周期异常无法处理日志输出。应将日志移到pumpAndSettle()之后，确保应用初始化完成后再执行。

4. 环境与框架版本排查 #

偶发性卡顿也可能和模拟器性能或框架版本有关：

• 给模拟器分配足够的CPU和内存资源
• 关闭模拟器开发者选项中的所有动画缩放（窗口动画、过渡动画、动画时长缩放）
• 升级Flutter到最新稳定版，排查是否存在已知的集成测试卡顿bug

修复后的完整代码 #

import 'package:flutter_test/flutter_test.dart';
import 'package:integration_test/integration_test.dart';

void main() {
  IntegrationTestWidgetsFlutterBinding.ensureInitialized();

  setUpAll(() {});
  tearDownAll(() async {});

  group('end-to-end test', () {
    testWidgets('Check route based on session', (tester) async {
      // 直接启动应用，无需runAsync包裹
      await app.main();
      // 等待应用完全初始化并渲染完成
      await tester.pumpAndSettle();

      // 读取token，确保异步操作完成
      final jwt = await secureStorage().read(key: "token");
      logIt().d(jwt);

      // 断言页面状态
      expect(
        find.byType(SplashPage, skipOffstage: false),
        jwt == null ? findsOneWidget : findsNothing,
      );
    });
  });
}

内容的提问来源于stack exchange，提问作者Umut Arpat