You need to enable JavaScript to run this app. Flutter如何存储contacts_service返回的Contact类型列表到SharedPreferences
优惠活动
大模型
产品
解决方案
定价
更多

Flutter如何存储contacts_service返回的Contact类型列表到SharedPreferences

核心错误原因

你两次报错的根源来自4个问题:

  • jsonEncode处理后的结果是单个String类型,你调用setStringList方法存储(该方法要求入参是List<String>),类型完全不匹配,读取时又把拿到的String强转为List,直接触发String is not a subtype of type 'List<dynamic>'报错
  • 存储和读取的key不一致:存的时候用的key是contactList,读的时候用的key是List,根本读不到已存储的数据
  • map()方法返回的是Iterable类型,没有调用toList()转成列表,无法直接赋值给List<Contact>类型变量
  • 异步操作没有加async/await:loadContacts方法未声明async,也没有await SharedPreferences的初始化逻辑,会提前返回空值
修复方案(基于现有SharedPreferences+Json实现)

存储代码

List<Contact> contacts = [];

Future<void> saveContacts() async {
  SharedPreferences prefs = await SharedPreferences.getInstance();
  // 先把所有Contact对象转成Map,再整体序列化为字符串
  final contactMapList = contacts.map((contact) => contact.toMap()).toList();
  final encodedStr = jsonEncode(contactMapList);
  // 用setString存储单个序列化字符串,不要用setStringList
  await prefs.setString('contactList', encodedStr);
}

读取代码

Future<void> loadContacts() async {
  SharedPreferences prefs = await SharedPreferences.getInstance();
  final String? encodedStr = prefs.getString('contactList');
  // 判空处理,避免首次读取无数据时报错
  if (encodedStr == null) {
    contacts = [];
    return;
  }
  // 先解码为dynamic列表,再逐个转为Contact对象,最后转成List
  final List<dynamic> decodedMapList = jsonDecode(encodedStr) as List;
  contacts = decodedMapList.map((mapItem) => Contact.fromMap(mapItem)).toList();
}
更优存储方案推荐

如果不需要强制用SharedPreferences,可以选择更适合结构化对象存储的三方库:

  • Hive:轻量级纯Dart键值数据库,支持直接存储自定义对象,无需手动做Json序列化,读写性能远高于SharedPreferences,适合存储联系人这类列表数据
  • Isar:如果后续有条件查询、排序等需求,可以用Isar,性能更强,支持索引、事务等特性,同样支持自定义对象直接持久化

内容的提问来源于stack exchange,提问作者Anan Saadi

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.09 02:15:01