使用Riverpod+SharedPreferences遇LateInitializationError问题求助

问题根源是你用late修饰的prefs变量依赖异步的SharedPreferences.getInstance()，但调用setBoardingValue时该异步操作还未完成，导致变量未初始化就被访问。下面是两种可行的解决方案：

方案一：提前初始化SharedPreferences并通过Provider注入 #

这种方式在App启动时就完成SharedPreferences的初始化，确保后续使用时实例已就绪。

1. 定义SharedPreferences的Provider #

final sharedPreferencesProvider = Provider<SharedPreferences>((ref) {
  throw UnimplementedError('请先初始化SharedPreferences');
});

2. 在main函数中完成初始化并注入 #

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 同步完成SharedPreferences初始化
  final prefs = await SharedPreferences.getInstance();
  runApp(
    ProviderScope(
      overrides: [
        sharedPreferencesProvider.overrideWithValue(prefs),
      ],
      child: const MyApp(),
    ),
  );
}

3. 修改PrefChangeNotifier依赖已初始化的实例 #

class PrefChangeNotifier extends ChangeNotifier {
  final SharedPreferences _prefs;

  // 构造函数直接接收已初始化的SharedPreferences
  PrefChangeNotifier(this._prefs);

  bool get boardingValue => _prefs.getBool('boarding') ?? false;

  void setBoardingValue(bool value) {
    _prefs.setBool('boarding', value);
    notifyListeners();
  }
}

4. 更新对应的ChangeNotifierProvider #

final prefChangeNotifierProvider = ChangeNotifierProvider<PrefChangeNotifier>((ref) {
  // 从Provider获取已初始化的SharedPreferences
  final prefs = ref.watch(sharedPreferencesProvider);
  return PrefChangeNotifier(prefs);
});

方案二：使用Riverpod的AsyncNotifier处理异步初始化 #

利用AsyncNotifier的build方法天然支持异步操作的特性，确保变量初始化完成后再执行业务逻辑。

1. 定义AsyncNotifier和对应的Provider #

final prefProvider = AsyncNotifierProvider<PrefNotifier, bool>((ref) => PrefNotifier());

class PrefNotifier extends AsyncNotifier<bool> {
  late final SharedPreferences _prefs;

  @override
  Future<bool> build() async {
    // 在build方法中完成异步初始化
    _prefs = await SharedPreferences.getInstance();
    // 返回初始状态
    return _prefs.getBool('boarding') ?? false;
  }

  Future<void> setBoardingValue(bool value) async {
    await _prefs.setBool('boarding', value);
    // 更新状态并通知监听者
    state = AsyncData(value);
  }
}

2. 调用方式 #

// 调用设置方法
ref.read(prefProvider.notifier).setBoardingValue(true);

// 读取状态
final boardingState = ref.watch(prefProvider);
boardingState.when(
  loading: () => const CircularProgressIndicator(),
  error: (err, stack) => Text('错误: $err'),
  data: (value) => Text('引导页状态: $value'),
);

两种方案都能避免late变量未初始化的问题，方案一更适合需要在多个地方共享SharedPreferences实例的场景，方案二更贴合Riverpod的异步状态管理范式。

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