Flutter/Riverpod中Mock StateNotifier遇初始化异常求助

问题原因 #

你遇到的「Tried to read the state of an uninitialized provider」错误，核心原因是：

• Mockito生成的MockClock没有执行StateNotifier的初始化逻辑。StateNotifier的内部状态（_state字段）必须通过构造函数的super()调用才能完成初始化，而默认的Mock类不会自动执行父类的构造逻辑。
• 即便你用when(mockClock.state).thenReturn(...)mock了state的getter，Riverpod在读取Provider时会检查StateNotifier的内部状态是否已初始化，未初始化的状态会触发该错误。

另外，你的测试思路绕了弯路：你不需要mock自己写的Clock类，而是应该mock它依赖的外部clock包实例——这才是单元测试中mock依赖的正确姿势。

解决方案一：修正Mock的初始化（不推荐，但解决当前问题） #

如果一定要mock自己的Clock类，需要强制Mock类执行父类的构造函数，初始化内部状态：

1. 修改Mock生成配置，指定构造参数：

@GenerateNiceMocks([
  MockSpec<Clock>(
    constructorArgs: [DateTime(2000)], // 传入初始状态，触发StateNotifier构造
    onMissingStub: OnMissingStub.returnDefault,
  ),
])

2. 测试代码中无需再mock state getter，直接使用即可：

testWidgets("test clock", (tester) async {
  final mockClock = MockClock();
  // 如需修改状态，直接赋值即可（StateNotifier的state是可写的）
  mockClock.state = DateTime(2000);

  final container = ProviderContainer(
    overrides: [
      clockProvider.overrideWithValue(mockClock),
    ],
  );

  final result = container.read(clockProvider);
  expect(result, DateTime(2000));
});

解决方案二：Mock外部依赖（推荐，更符合单元测试最佳实践） #

你的Clock类核心依赖是clock包提供的clock实例，直接mock这个外部依赖，无需修改自己的Clock类的测试逻辑：

步骤1：封装外部clock为Provider #

先把clock包的实例封装成一个Provider，方便测试时替换：

// 封装clock包的实例为Provider
final externalClockProvider = Provider<Clock>((ref) => clock);

// 修改原ClockProvider，依赖这个封装的Provider
final clockProvider = StateNotifierProvider<Clock, DateTime>((ref) {
  final externalClock = ref.watch(externalClockProvider);
  return Clock(externalClock);
});

// 修改Clock类，接收外部clock作为参数
class Clock extends StateNotifier<DateTime> {
  late final Timer _timer;
  final Clock _externalClock;

  Clock(this._externalClock) : super(_externalClock.now()) {
    _timer = Timer.periodic(const Duration(seconds: 1), (_) {
      state = _externalClock.now();
    });
  }

  @override
  void dispose() {
    _timer.cancel();
    super.dispose();
  }
}

步骤2：编写测试代码 #

为clock包的Clock类生成Mock，然后在测试中替换externalClockProvider：

@GenerateNiceMocks([
  MockSpec<Clock>(), // 这里mock的是clock包的Clock类
])

void main() {
  testWidgets("test clock", (tester) async {
    // 固定测试时间
    final fixedTime = DateTime(2000);
    final mockExternalClock = MockClock();
    // mock now()方法返回固定时间
    when(mockExternalClock.now()).thenReturn(fixedTime);

    final container = ProviderContainer(
      overrides: [
        externalClockProvider.overrideWithValue(mockExternalClock),
      ],
    );

    final result = container.read(clockProvider);
    expect(result, fixedTime);
  });
}

为什么方案二更优 #

• 单元测试的核心是测试自己的业务逻辑，而非测试框架或第三方依赖。mock外部依赖（clock包）可以让你聚焦于验证Clock类的逻辑是否正确，而不是处理StateNotifier的mock细节。
• 这种方式更灵活：你可以轻松模拟时间变化（比如多次调用when(mockExternalClock.now()).thenReturn(...)返回不同时间），测试Clock类的定时更新逻辑。

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