Flutter Riverpod AsyncNotifier报错：Future already completed 如何解决？

问题原因 #

这个异常通常是因为AsyncNotifier的状态（state）被重复修改，或者AsyncValue内部的Completer被多次触发。在你的logout实现中，手动设置state = const AsyncLoading()后，紧接着用await AsyncValue.guard(...)赋值state，针对void类型的异步操作（FirebaseAuth.instance.signOut()返回Future<void>），容易出现状态处理冲突。

解决方案 #

以下提供几种可行的修复方式：

方案1：手动处理异步状态（推荐，更直观）

替换AsyncValue.guard，手动捕获错误并更新状态，避免潜在的状态冲突：

Future<void> logout() async {
  state = const AsyncLoading();
  try {
    await FirebaseAuth.instance.signOut();
    // 用AsyncData(null)表示void类型操作的成功状态
    state = const AsyncData(null);
  } catch (e, stackTrace) {
    state = AsyncError(e, stackTrace);
  }
}

方案2：移除手动Loading状态（无需显示加载时使用）

如果不需要显式展示加载状态，直接用AsyncValue.guard处理整个流程：

Future<void> logout() async {
  state = await AsyncValue.guard(() => FirebaseAuth.instance.signOut());
}

方案3：保留Loading状态并兼容之前的状态

如果需要显示加载状态且希望保留之前的状态上下文，使用copyWithPrevious避免状态冲突：

Future<void> logout() async {
  state = AsyncValue.loading().copyWithPrevious(state);
  state = await AsyncValue.guard(() => FirebaseAuth.instance.signOut());
}

额外检查 #

同时注意你的signIn方法：如果authRepository.signIn返回的是非void类型（比如User对象），那么当前AuthController的state类型（AsyncValue<void>）会存在类型不匹配的问题，需要调整build方法的返回类型为对应类型，例如：

@override
FutureOr<User?> build() {
  return null;
}

内容的提问来源于stack exchange，提问作者Mosh Mobile Software Engineer