Flutter中如何使用Hive存储与检索图片？

Hive本身不直接支持二进制大对象存储，但可以通过将图片转换为Uint8List或Base64字符串的方式实现存储与检索，以下是具体实现步骤：

1. 准备工作 #

• 添加Hive相关依赖到pubspec.yaml：

dependencies:
  hive: ^2.2.3
  hive_flutter: ^1.1.0
dev_dependencies:
  hive_generator: ^1.1.5
  build_runner: ^2.1.7

• 在main函数中初始化Hive：

void main() async {
  await Hive.initFlutter();
  await Hive.openBox('images_box');
  runApp(MyApp());
}

2. 存储图片 #

方式一：转换为Uint8List存储（推荐，性能更高） #

从相册或相机获取图片后，读取其二进制数据存入Hive：

final pickedFile = await ImagePicker().pickImage(source: ImageSource.gallery);
if (pickedFile != null) {
  final imageBytes = await pickedFile.readAsBytes();
  final imageBox = Hive.box('images_box');
  // 用时间戳作为唯一键，避免数据覆盖
  await imageBox.put('img_${DateTime.now().millisecondsSinceEpoch}', imageBytes);
}

方式二：转换为Base64字符串存储 #

若需跨平台兼容字符串场景，可使用此方式：

final pickedFile = await ImagePicker().pickImage(source: ImageSource.gallery);
if (pickedFile != null) {
  final imageBytes = await pickedFile.readAsBytes();
  final base64Str = base64Encode(imageBytes);
  final imageBox = Hive.box('images_box');
  await imageBox.put('img_1', base64Str);
}

3. 检索并展示图片 #

针对Uint8List数据的展示 #

从Hive取出数据后，直接用Image.memory组件渲染：

final imageBox = Hive.box('images_box');
final targetBytes = imageBox.get('img_1690000000000'); // 替换为实际存储的键
if (targetBytes != null) {
  return Image.memory(targetBytes as Uint8List);
} else {
  return const Text('无可用图片');
}

针对Base64字符串数据的展示 #

先解码为Uint8List再渲染：

final imageBox = Hive.box('images_box');
final targetBase64 = imageBox.get('img_1');
if (targetBase64 != null) {
  final imageBytes = base64Decode(targetBase64 as String);
  return Image.memory(imageBytes);
} else {
  return const Text('无可用图片');
}

注意事项 #

• 避免存储未压缩的大尺寸图片，会导致Hive性能下降，建议使用flutter_image_compress等工具先压缩图片。
• 确保存储的图片键唯一，防止数据被意外覆盖。
• 若需管理多张图片，可在Hive中存储一个键列表，统一维护所有图片的索引。

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