Flutter RiverPod：如何将FutureProvider结果传入普通Provider

问题详情 #

我在Flutter项目中使用RiverPod时遇到类型不匹配问题：需要将FutureProvider获取的SharedPreferences实例传入普通Provider创建ProfileRepository，但ref.watch返回的是AsyncValue<SharedPreferences>而非实际实例，导致报错。

代码示例：

class ProfileRepository {
  final SharedPreferences prefs;

  ProfileRepository({required this.prefs});

  // 其他方法
}

@riverpod
Future<SharedPreferences> sharedPreferences(SharedPreferencesRef ref) async {
  return await SharedPreferences.getInstance();
}

@riverpod
ProfileRepository profileRepository(ProfileRepositoryRef ref) {
  final prefs = ref.watch(sharedPreferencesProvider); // 返回AsyncValue<SharedPreferences>
  return ProfileRepository(prefs: prefs); // 此处报错
}

错误信息：

The argument type 'AsyncValue<SharedPreferences>' can't be assigned to the parameter type 'SharedPreferences'.

已尝试方案：

• 考虑将profileRepository转为FutureProvider，但会大幅改变现有架构，希望避免
• 不确定如何在非异步Provider中从AsyncValue提取实际实例

解决方案 #

方案1：使用AsyncValue.requireValue直接获取实例 #

通过requireValue从AsyncValue中提取已完成的实例，注意需确保Future已加载完成（可在UI层先处理加载状态）。

修改profileRepositoryProvider：

@riverpod
ProfileRepository profileRepository(ProfileRepositoryRef ref) {
  final prefsAsync = ref.watch(sharedPreferencesProvider);
  // 仅当Future成功完成时返回实例，未完成/出错时会抛出StateError
  final prefs = prefsAsync.requireValue;
  return ProfileRepository(prefs: prefs);
}

UI层使用时需先处理sharedPreferences的状态：

ref.watch(sharedPreferencesProvider).when(
  loading: () => const CircularProgressIndicator(),
  error: (err, stack) => Text('加载失败：$err'),
  data: (_) {
    // 此时SharedPreferences已就绪，可安全获取Repository
    final repo = ref.watch(profileRepositoryProvider);
    return ProfileWidget(repo: repo);
  },
);

方案2：让普通Provider返回AsyncValue<ProfileRepository> #

不改变Provider类型，而是返回包装后的AsyncValue，由UI层统一处理状态：

@riverpod
AsyncValue<ProfileRepository> profileRepository(ProfileRepositoryRef ref) {
  return ref.watch(sharedPreferencesProvider).whenData(
    (prefs) => ProfileRepository(prefs: prefs),
  );
}

UI层使用：

ref.watch(profileRepositoryProvider).when(
  loading: () => const CircularProgressIndicator(),
  error: (err, stack) => Text('加载失败：$err'),
  data: (repo) => ProfileWidget(repo: repo),
);

方案3：提前初始化SharedPreferences（推荐） #

在main函数中提前异步获取SharedPreferences，然后通过ProviderScope的overrides直接注入已就绪的实例，这样普通Provider可直接获取同步值。

修改main函数：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 提前初始化SharedPreferences
  final prefs = await SharedPreferences.getInstance();
  runApp(
    ProviderScope(
      overrides: [
        // 将FutureProvider的结果替换为已完成的AsyncData
        sharedPreferencesProvider.overrideWithValue(AsyncData(prefs)),
      ],
      child: const MyApp(),
    ),
  );
}

此时profileRepositoryProvider可直接使用：

@riverpod
ProfileRepository profileRepository(ProfileRepositoryRef ref) {
  final prefs = ref.watch(sharedPreferencesProvider).requireValue;
  return ProfileRepository(prefs: prefs);
}

这种方式无需在UI层额外处理加载状态，适合全局依赖的初始化场景。

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