Flutter使用GetIt做依赖注入时单元测试并行运行报错如何解决

报错是因为GetIt默认使用全局单例实例，而Dart单元测试默认并行执行时，不同测试的reset、依赖注册操作会抢占全局实例，加上你当前代码未等待异步的reset操作执行完成就进行后续注册，进一步放大了冲突概率。

方案1：禁用测试并行运行 #

如果不想调整现有测试逻辑，可以直接强制测试串行执行，避免实例抢占：

• 临时单次运行生效：执行测试命令时添加并发数参数

  flutter test --concurrency=1
  

• 固定为单个测试文件禁用并行：
  1. 在测试文件首行添加 @Tags(['no-parallel'])
  2. 在项目根目录创建/修改dart_test.yaml，添加如下配置：

  tags:
    no-parallel:
      concurrency: 1
  

方案2：安全使用GetIt的最优方案（推荐，不影响测试执行效率） #

2.1 补全异步等待，统一用setUp/tearDown管理依赖 #

注意：GetIt.I.reset() 是异步方法，必须添加await等待执行完成，否则会出现重置和注册逻辑时序错乱的问题
改造测试结构，把公共的重置、注册逻辑放到setUp/tearDown中统一管理：

void main() {
  group("tests", () {
    // 每次测试执行前完成依赖重置与注册
    setUp(() async {
      await GetIt.I.reset();
      GetIt.I.registerSingleton(MyDependency());
    });

    // 每次测试执行后清理实例
    tearDown(() async {
      await GetIt.I.reset();
    });

    test("test1", () {
      final dep = GetIt.I<MyDependency>();
      // 测试逻辑
    });

    test("test2", () {
      final dep = GetIt.I<MyDependency>();
      // 测试逻辑
    });
  });
}

2.2 用独立GetIt作用域实现完全隔离（彻底解决并行冲突） #

GetIt支持创建独立的实例作用域，每个测试使用单独的作用域，完全不会和其他测试产生冲突，即使测试并行运行也不会有问题：

void main() {
  group("tests", () {
    late GetIt testScope;

    setUp(() {
      // 每个测试创建独立的GetIt实例
      testScope = GetIt.asNewInstance();
      testScope.registerSingleton(MyDependency());
      // 替换全局GetIt实例，兼容业务代码的全局调用写法
      GetIt.I = testScope;
    });

    tearDown(() async {
      await testScope.reset();
    });

    test("test1", () {
      final dep = GetIt.I<MyDependency>();
      // 测试逻辑
    });

    test("test2", () {
      final dep = GetIt.I<MyDependency>();
      // 测试逻辑
    });
  });
}

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