Flutter单元测试：如何验证构造函数内调用的loadSpecies方法

问题核心 #

验证混入ChangeNotifier的TodoProvider类，无参构造函数执行阶段是否正确触发内部loadSpecies()方法，同时避免执行方法内真实的API请求逻辑。

待测试类代码 #

class TodoProvider with ChangeNotifier {
  TodoProvider() {
    loadSpecies();
  }
       
  loadSpecies() {
    /* 此处为API请求逻辑 */
  }
}

初始测试代码（待补全） #

test('Initialization', () async {
  when(EstablishmentProvider());
});

注：初始代码存在两处明显问题：一是测试目标类名写错（待验证的是TodoProvider而非EstablishmentProvider），二是when是Mock库的存根语法，直接传入构造函数无任何实际作用。

实现思路 #

不需要引入复杂的Mock框架也能完成验证，核心思路是创建测试专用子类重写loadSpecies方法，通过标记位记录方法调用状态。Dart的动态派发机制会保证父类构造函数调用loadSpecies时，实际执行的是子类重写后的版本，不会触发真实API请求：

• 定义测试子类继承TodoProvider，新增调用状态标记位，重写loadSpecies方法修改标记位，不调用父类实现避免真实网络请求
• 实例化测试子类，若loadSpecies为异步方法，等待所有待执行微任务完成
• 断言标记位符合预期，证明构造阶段确实调用了目标方法

完整测试代码 #

场景1：loadSpecies为同步方法 #

test('构造函数初始化时应调用loadSpecies方法', () {
  // 定义测试替身
  class TestTodoProvider extends TodoProvider {
    bool loadSpeciesCalled = false;

    @override
    loadSpecies() {
      loadSpeciesCalled = true;
      // 不调用super.loadSpecies()，屏蔽真实API逻辑
    }
  }

  // 实例化会自动执行构造函数
  final provider = TestTodoProvider();

  // 验证方法被调用
  expect(provider.loadSpeciesCalled, isTrue);
});

场景2：loadSpecies为异步API请求方法（绝大多数实际场景） #

如果loadSpecies是返回Future的异步方法，且构造函数中没有用await等待它执行完成（现有代码就是这种情况），实例化后需要等待事件队列清空再做断言：

test('构造函数初始化时应调用loadSpecies方法', () async {
  class TestTodoProvider extends TodoProvider {
    bool loadSpeciesCalled = false;

    @override
    Future<void> loadSpecies() async {
      loadSpeciesCalled = true;
      // 不调用super.loadSpecies()，屏蔽真实API逻辑
    }
  }

  final provider = TestTodoProvider();
  // 等待所有排队的异步任务执行完成
  await Future<void>.delayed(Duration.zero);

  expect(provider.loadSpeciesCalled, isTrue);
});

如果使用mockito等Mock库，也可以通过Mock类自动统计调用次数，核心逻辑和上述手写测试替身完全一致，本质都是替换loadSpecies的真实实现来记录调用状态，避免触发真实网络请求。

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