调用Hive.openBox()后仍提示Box not found报错该如何解决

核心错误原因 #

• Hive.openBox() 是异步方法，你原代码中没有加await关键字，导致传递给下一页的data是Future<Box>类型，而非已经完成初始化的Box实例，这是报错的核心诱因。
• 页面参数传递逻辑不匹配：跳转时你传入了setTask.getAt(index)、data两个参数，但Tasks页面的构造函数仅定义了一个接收参数，参数对应关系错误。
• 不要在build方法中执行Hive.openBox()操作，build方法会随页面重绘多次触发，重复调用打开方法会引发额外异常。

修正代码 #

跳转前页面点击逻辑 #

GestureDetector(
   onTap: () async{
     // 先获取box名称，加await等待Box打开完成
     final boxName = setTask.getAt(index).toString();
     final openedBox = await Hive.openBox(boxName);
     // 页面跳转不需要套setState
     Navigator.push(
        context,
        MaterialPageRoute(builder: (context) => Tasks(
          hiveName: boxName,
          openedBox: openedBox
        )),
     );
   },
);

跳转后Tasks页面参数接收 #

// 定义两个参数对应传入的内容
final String hiveName;
final Box openedBox;

const Tasks({
  super.key,
  required this.hiveName,
  required this.openedBox,
});

优化建议 #

• 如果是全局通用的固定名称Box，建议在App启动阶段就提前打开，放在main方法runApp执行前完成初始化，不需要页面跳转时临时打开，参考示例：

  void main() async {
    await Hive.initFlutter();
    // 提前打开固定名称的Box，动态名称Box可按需打开
    // await Hive.openBox('common_box');
    runApp(const MyApp());
  }
  

• 操作Box前可先调用Hive.isBoxOpen('boxName')校验对应Box是否处于打开状态，确认名称完全匹配无拼写、特殊字符误差后再执行读写操作。

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