Flutter使用SharedPreferences存储TableCalendar事件报错求助

问题根源 #

你遇到的两个问题均由序列化/反序列化逻辑错误导致：

1. 类型报错的核心原因：存储事件时错误将Map结构转为字符串再做JSON编码，读取时解析得到的是字符串而非预期的Map结构，触发类型不匹配异常。
2. 首次添加不显示的核心原因：Event类没有实现序列化逻辑，且编解码方法的类型转换逻辑错误，导致事件数据无法被正确存储和解析。

修复步骤 #

1. 改造Event类，新增序列化/反序列化方法 #

import 'package:flutter/foundation.dart';

class Event{
  final String title;
  Event({required this.title});

  // 新增toJson方法用于序列化
  Map<String, dynamic> toJson() => {
    'title': title,
  };

  // 新增fromJson方法用于反序列化
  static Event fromJson(Map<String, dynamic> json) => Event(
    title: json['title'],
  );

  @override
  String toString() => title;
}

2. 修正encodeMap编码方法 #

// 入参明确为Map<DateTime, List<Event>>，返回可直接JSON序列化的结构
Map<String, dynamic> encodeMap(Map<DateTime, List<Event>> map) {
  Map<String, dynamic> newMap = {};
  map.forEach((key, value) {
    // 用toIso8601String作为日期key，比toString更规范，解析无精度问题
    // 同时把List<Event>转为List<Map>结构，支持JSON序列化
    newMap[key.toIso8601String()] = value.map((event) => event.toJson()).toList();
  });
  return newMap;
}

3. 修正decodeMap解码方法 #

// 入参为jsonDecode返回的通用Map<String, dynamic>结构
Map<DateTime, List<Event>> decodeMap(Map<String, dynamic> map) {
  Map<DateTime, List<Event>> newMap = {};
  map.forEach((key, value) {
    // 把解析得到的List<dynamic>转为List<Event>
    List<Event> eventList = (value as List<dynamic>).map((item) => Event.fromJson(item)).toList();
    newMap[DateTime.parse(key)] = eventList;
  });
  return newMap;
}

4. 修正事件存储逻辑 #

找到添加事件按钮的onPressed方法里的存储代码，去掉多余的toString()调用：

// 错误写法：
// prefs.setString("events", jsonEncode(encodeMap(events).toString()));
// 正确写法：
prefs.setString("events", jsonEncode(encodeMap(events)));

5. 修正初始化读取逻辑 #

修改prefsData方法，简化类型转换：

Future prefsData() async {
  prefs = await SharedPreferences.getInstance();
  final eventString = prefs.getString("events");
  if (eventString != null) {
    setState(() {
      events = decodeMap(jsonDecode(eventString));
    });
  }
}

额外优化建议 #

• 代码中定义的selectedEvents变量没有被使用，可以直接删除避免冗余。
• 当前TableCalendar的firstDay和lastDay设置为2021-2022年，如果需要使用当前日期，记得调整时间范围。

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