Flutter代码中SharedPreferences未初始化的原因排查

你的问题核心在于构造函数和异步初始化的执行顺序冲突：

• 构造函数是同步执行的，当你在构造函数里调用initializeSharedPrefs()时，方法内的await SharedPreferences.getInstance()是异步操作，会直接返回而不会阻塞构造函数的执行流程。
• 这就导致构造函数执行完毕时，prefs变量根本还没完成初始化，此时调用getSavedNews()必然触发LateInitializationError。

方案1：异步工厂构造函数 #

将构造函数改为异步工厂方法，确保prefs初始化完成后再返回类实例：

class NewsApiRepository {
  late SharedPreferences prefs;

  // 异步工厂构造函数，确保初始化完成再返回实例
  factory NewsApiRepository() async {
    final repo = NewsApiRepository._();
    repo.prefs = await SharedPreferences.getInstance();
    return repo;
  }

  NewsApiRepository._();

  void getSavedNews() {
    final codedData = prefs.getString(key);
  }
}

使用时需要通过await获取实例：

final repo = await NewsApiRepository();
repo.getSavedNews();

方案2：显式初始化方法 #

给类添加公开的初始化方法，要求调用者必须先完成初始化再使用功能：

class NewsApiRepository {
  late SharedPreferences prefs;

  Future<void> init() async {
    prefs = await SharedPreferences.getInstance();
  }

  void getSavedNews() {
    // 可选：添加断言确保已初始化
    assert(prefs != null, "请先调用init()完成初始化");
    final codedData = prefs.getString(key);
  }
}

使用流程：

final repo = NewsApiRepository();
await repo.init();
repo.getSavedNews();

方案3：用Future替代late关键字 #

直接把prefs定义为Future<SharedPreferences>类型，使用时通过await获取实例（SharedPreferences.getInstance()本身是单例，多次await不会重复初始化）：

class NewsApiRepository {
  final Future<SharedPreferences> _prefs = SharedPreferences.getInstance();

  Future<void> getSavedNews() async {
    final prefs = await _prefs;
    final codedData = prefs.getString(key);
  }
}

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