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的初始化逻辑,会提前返回空值
存储代码
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
相关产品推荐
相关产品推荐

