Flutter Objectbox中如何存储Map类型数据？Map类型不被支持的原因及解决方案示例请求

首先说下为什么你的Map<String, Object>会被忽略：ObjectBox是一个基于对象的嵌入式数据库，它要求实体的属性类型是可直接映射到数据库存储结构的明确类型（比如int、String、bool，或者其他标注了@Entity的自定义类）。而Map是动态的键值对集合，尤其是Map<String, Object>这种值类型不固定的结构，ObjectBox没办法把它映射成固定的数据库列或者表结构，所以会直接跳过这个属性。

下面给你两种可行的解决方案，附带示例代码：

方案1：将Map序列化为JSON字符串存储 #

这是最简单的方案，把Map转换成JSON字符串，存为String类型的属性，读取的时候再反序列化为Map。

修改后的实体类代码 #

import 'dart:convert';
import 'package:objectbox/objectbox.dart';

@Entity()
class PlaylistItem {
  int id = 0;
  int recentIndex;
  // 把原来的Map改成String类型，用来存JSON
  String songInfoJson;

  PlaylistItem({
    this.recentIndex = 0,
    Map<String, Object> songInfo = const <String, Object>{},
  }) : songInfoJson = jsonEncode(songInfo);

  // 辅助方法：从JSON字符串转回Map
  Map<String, Object> get songInfo => jsonDecode(songInfoJson) as Map<String, Object>;

  // 辅助方法：更新Map并同步到JSON字符串
  set songInfo(Map<String, Object> newInfo) {
    songInfoJson = jsonEncode(newInfo);
  }
}

使用示例 #

// 创建一个带Map的PlaylistItem
final item = PlaylistItem(
  recentIndex: 1,
  songInfo: {'title': 'Hello', 'duration': 180, 'isFavorite': true},
);

// 存入Box
final box = store.box<PlaylistItem>();
box.put(item);

// 读取并获取Map
final savedItem = box.get(item.id)!;
print(savedItem.songInfo['title']); // 输出 Hello

这种方案的优点是简单快捷，适合结构不复杂、不需要单独查询Map内字段的场景；缺点是没办法直接对Map里的键值对做数据库查询。

方案2：将Map拆分为关联实体 #

如果需要对Map里的内容进行单独查询（比如查找所有包含某个songInfo键值对的PlaylistItem），可以把Map的每个键值对拆成一个独立的实体，通过外键和PlaylistItem关联。

步骤1：创建关联实体 #

@Entity()
class SongInfoEntry {
  int id = 0;
  // 外键，关联到PlaylistItem的id
  final playlistItem = ToOne<PlaylistItem>();
  String key;
  // 这里如果值的类型多样，可以用String存储，或者根据类型分字段（比如intValue、stringValue等）
  String value;

  SongInfoEntry({required this.key, required this.value});
}

步骤2：修改PlaylistItem实体 #

@Entity()
class PlaylistItem {
  int id = 0;
  int recentIndex;
  // 关联所有对应的SongInfoEntry
  final songInfo = ToMany<SongInfoEntry>();

  PlaylistItem({this.recentIndex = 0});
}

使用示例 #

// 创建PlaylistItem和对应的SongInfoEntry
final item = PlaylistItem(recentIndex: 1);
final entries = [
  SongInfoEntry(key: 'title', value: 'Hello'),
  SongInfoEntry(key: 'duration', value: '180'),
  SongInfoEntry(key: 'isFavorite', value: 'true'),
];
item.songInfo.addAll(entries);

// 存入Box（注意要先存PlaylistItem，再存关联的Entry，或者用box.putMany加上putModePut）
final box = store.box<PlaylistItem>();
final entryBox = store.box<SongInfoEntry>();
box.put(item);
entryBox.putMany(entries);

// 读取并转换为Map
final savedItem = box.get(item.id)!;
final songInfoMap = {
  for (var entry in savedItem.songInfo) entry.key : _parseValue(entry.value),
};
print(songInfoMap['title']); // 输出 Hello

// 辅助方法：根据字符串转回对应类型
dynamic _parseValue(String value) {
  if (value == 'true' || value == 'false') return value == 'true';
  final numValue = num.tryParse(value);
  if (numValue != null) return numValue;
  return value;
}

这种方案的优点是可以对Map里的键值对进行数据库查询（比如查找所有songInfo包含key为'title'且value为'Hello'的PlaylistItem），缺点是实现起来更繁琐，适合需要复杂查询的场景。

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