Dart中如何将键为DateTime类型的Map编码为JSON格式？

问题根因 #

你遇到的报错和Map的值为List类型无关，核心问题是JSON规范仅支持字符串作为键的类型，Dart内置的json.encode默认只能自动序列化String、num、bool、List、Map<String, dynamic>这几类基础类型，DateTime作为Map的键不属于默认支持的可序列化类型，因此抛出转换失败的异常。

解决方案 #

方案1：手动转换DateTime键为字符串（推荐） #

序列化时先将所有DateTime类型的键转为标准的ISO8601格式字符串，生成符合要求的Map<String, dynamic>后再序列化；反序列化时再把字符串键转回DateTime类型即可。
序列化代码示例：

final originalMap = {
  DateTime.now(): ["Sample data", 3, true, "Example", 2],
};
// 将DateTime键转为ISO8601字符串
final serializableMap = originalMap.map(
  (dateKey, value) => MapEntry(dateKey.toIso8601String(), value),
);
// 正常序列化
String encoded = json.encode(serializableMap);

反序列化代码示例：

final decodedJson = json.decode(encoded) as Map<String, dynamic>;
// 把字符串键转回DateTime
final restoredMap = decodedJson.map(
  (stringKey, value) => MapEntry(DateTime.parse(stringKey), value as List),
);

方案2：使用toEncodable参数自定义序列化逻辑 #

如果需要统一处理自定义类型的序列化，可以给json.encode传入toEncodable回调：

final originalMap = {
  DateTime.now(): ["Sample data", 3, true, "Example", 2],
};
String encoded = json.encode(
  originalMap,
  toEncodable: (object) {
    if (object is DateTime) {
      return object.toIso8601String();
    }
    return object;
  },
);

注意该方案反序列化时仍需要手动将字符串键转回DateTime类型，逻辑和方案1的反序列化步骤一致。

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