Dart开发中如何将DateTime类型映射存储到SQFlite数据库

核心问题根因 #

报错本质是你在调用SQFlite的数据库操作方法时，传入的参数中存在未转换的DateTime类型值，你写的toMap转换逻辑本身是符合官方规范的，触发报错大概率是以下几个常见场景导致：

• 代码修改后未生效：Flutter热重载未更新实体类方法，实际运行时调用的还是未做DateTime转换的旧代码
• 存在其他未转换的调用场景：除了insert操作外，update、query的查询参数里直接传入了DateTime类型值
• 旧数据库表缓存：之前创建的表字段类型不匹配，或者旧数据格式和现有转换逻辑冲突

可行修复方案 #

方案1：继续使用ISO8601字符串存储（官方推荐，可读性强） #

1. 先完善实体类的类型声明，避免隐式类型转换异常，修改后的calendar_day.dart代码如下：

class CalendarDay {
  int? id;
  DateTime date; 

  CalendarDay({
    this.id,
    required this.date
  });

  // 编码为SQLite可识别格式
  Map<String, dynamic> toMap() {
    final map = <String, dynamic>{};
    map['id'] = id;
    // 确认此处转换为String类型
    map['date'] = date.toIso8601String();
    // 可加一行调试代码确认转换结果类型，确认没问题后删掉即可
    // print('toMap中date的类型：${map['date'].runtimeType}');
    return map;
  }

  // 明确声明返回值类型为CalendarDay
  static CalendarDay fromMap(Map<String, dynamic> map) {
    return CalendarDay(
      id: map['id'] as int?,
      date: DateTime.parse(map['date'] as String),
    );
  }
}

2. 卸载应用，清空本地旧数据库后重新安装运行，排除旧代码缓存、旧表结构的影响。
3. 检查所有数据库操作的参数：确认update、query等操作的参数中没有直接传入DateTime类型值，比如查询指定日期的代码需要写成：

// 错误写法：直接传DateTime
// await database.query(Strings.calendarDayDataBase, where: 'date = ?', whereArgs: [DateTime.now()]);
// 正确写法：先转成ISO8601字符串
await database.query(
  Strings.calendarDayDataBase, 
  where: 'date = ?', 
  whereArgs: [DateTime.now().toIso8601String()]
);

方案2：使用毫秒时间戳存储（性能更优，无编码兼容问题） #

如果字符串转换还是有问题，可以换成int类型的时间戳存储，修改对应代码即可：

1. 修改calendar_day.dart的转换逻辑：

class CalendarDay {
  int? id;
  DateTime date; 

  CalendarDay({
    this.id,
    required this.date
  });

  Map<String, dynamic> toMap() {
    final map = <String, dynamic>{};
    map['id'] = id;
    map['date'] = date.millisecondsSinceEpoch;
    return map;
  }

  static CalendarDay fromMap(Map<String, dynamic> map) {
    return CalendarDay(
      id: map['id'] as int?,
      date: DateTime.fromMillisecondsSinceEpoch(map['date'] as int),
    );
  }
}

2. 修改database_client.dart中的表创建语句，将date字段类型改为INTEGER：

await database.execute(
  "CREATE TABLE ${Strings.calendarDayDataBase} (id INTEGER PRIMARY KEY, date INTEGER)",
);

3. 卸载应用清空旧数据库后重新运行即可。

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