Flutter集成测试用例执行顺序是否确定？如何强制固定顺序？

测试用例是否会按定义顺序执行？ #

当前版本的Flutter中，同一个group内的testWidgets确实会按照代码里的定义顺序执行，但这个行为没有官方的长期稳定性保证。Dart测试框架的设计原则是测试用例独立，未来版本可能会引入并行执行或打乱顺序的优化，所以不能完全依赖默认顺序来保证测试正确性。

如何强制指定测试执行顺序？ #

如果你必须确保特定测试用例最后执行，有几种可靠的方法：

方法1：使用@Order注解（推荐） #

Flutter依赖的package:test库支持通过@Order注解明确定义测试用例的执行优先级，数字越小的测试会先执行。

修改你的代码如下：

// integration_test/login_test.dart

import 'package:flutter_test/flutter_test.dart';
import 'package:test/test.dart'; // 显式导入以使用@Order注解

void main() {
  group('login screen', () {
    @Order(1)
    testWidgets(
      'shows proper error message when email has incorrect format',
      (tester) async {
        // 测试代码
      },
    );

    @Order(2)
    testWidgets(
      'shows error message when password is incorrect',
      (tester) async {
        // 测试代码
      },
    );

    @Order(3)
    testWidgets(
      'logs in with correct credentials',
      (tester) async {
        // 测试代码
      },
    );
  });
}

也可以用链式调用的写法替代注解：

testWidgets(
  'shows proper error message when email has incorrect format',
  (tester) async { /* 测试代码 */ },
)..order = 1;

方法2：嵌套group分组控制顺序 #

把不需要登录的测试用例放在一个嵌套group中，登录测试放在外层group的最后。因为group会按定义顺序执行内部的测试和子group，所以嵌套group里的所有测试会先执行，之后才会执行外层的登录测试。

示例代码：

// integration_test/login_test.dart

import 'package:flutter_test/flutter_test.dart';

void main() {
  group('login screen', () {
    group('invalid login attempts', () {
      testWidgets(
        'shows proper error message when email has incorrect format',
        (tester) async {
          // 测试代码
        },
      );

      testWidgets(
        'shows error message when password is incorrect',
        (tester) async {
          // 测试代码
        },
      );
    });

    testWidgets(
      'logs in with correct credentials',
      (tester) async {
        // 测试代码
      },
    );
  });
}

方法3：单个测试用例内按顺序执行步骤 #

如果不需要单独的测试报告，可以把三个测试逻辑合并到同一个testWidgets中，按顺序执行，执行完每个测试后重置应用状态（比如回到登录页）。

示例：

// integration_test/login_test.dart

import 'package:flutter_test/flutter_test.dart';

void main() {
  testWidgets('login screen full flow tests', (tester) async {
    // 测试1：邮箱格式错误
    // 测试代码...
    
    // 重置状态：回到登录页
    await tester.pageBack(); // 或其他重置逻辑
    
    // 测试2：密码错误
    // 测试代码...
    
    // 重置状态：回到登录页
    await tester.pageBack();
    
    // 测试3：正确登录
    // 测试代码...
  });
}

这种方法的缺点是无法单独查看每个子测试的结果，适合简单场景。

内容的提问来源于stack exchange，提问作者Bartek Pacia