Flutter中如何向Hive存取数据？遇到get调用null报错怎么解决？

你遇到的get was called on null报错，本质是调用box.get/box.put时，box变量还没有被赋值、对应的Hive盒子也没有完成打开操作。

1. 启动时预初始化全局可用的Box（推荐，适合小体积常用盒子） #

首先在全局位置（比如main.dart顶层）声明Box变量：

// 顶层全局声明，避免每个页面重复声明
late Box workoutBox;

修改入口main函数逻辑，等待盒子初始化完成再启动应用：

void main() async {
  // 必须先完成Flutter引擎初始化，否则异步操作会触发报错
  WidgetsFlutterBinding.ensureInitialized();
  await Hive.initFlutter();
  // 等待盒子打开完成，赋值给全局变量
  workoutBox = await Hive.openBox('workoutBox');
  runApp(const MyApp());
}

2. 页面存取数据的正确写法 #

全局变量已经完成初始化，不需要在页面单独声明box、也不需要重复打开盒子，直接调用即可：

存数据 #

Future<void> _save() async{
  final Id = doc.id;
  workoutBox.put("Id", Id);
}

读数据 #

// 建议添加defaultValue参数，避免key不存在时返回null引发空安全报错
var someId = workoutBox.get("Id", defaultValue: "");

3. 懒加载方案（适合大体积、不常用的盒子） #

如果盒子体积大，不想在启动时打开占用首屏加载时间，可以用懒加载的方式处理：
首先修改全局声明：

Box? workoutBox;

封装统一的盒子获取方法：

Future<Box> getWorkoutBox() async {
  if(workoutBox != null && workoutBox!.isOpen) {
    return workoutBox!;
  }
  workoutBox = await Hive.openBox('workoutBox');
  return workoutBox!;
}

存取数据前先调用方法获取盒子实例：

// 存数据
Future<void> _save() async{
  final Id = doc.id;
  final box = await getWorkoutBox();
  box.put("Id", Id);
}

// 读数据
Future<String?> getId() async {
  final box = await getWorkoutBox();
  return box.get("Id", defaultValue: "");
}

• 不要重复打开同名Box，Hive会自动复用已打开的盒子，重复调用openBox只会增加不必要的异步等待
• 读取不存在的key会默认返回null，建议所有读取操作都配置defaultValue参数规避空安全报错
• 一般场景下不需要主动关闭Box，应用退出时系统会自动处理资源回收

内容的提问来源于stack exchange，提问作者who-aditya-nawandar