Flutter使用Hive读取数据出现Bad state和类型转换错误如何解决？

错误1：Bad state: No element #

原因：首次启动应用时，projectBox中未写入过任何数据，values返回空的可迭代对象，直接调用.first会触发空迭代器访问异常，新增的isEmpty判断已经解决了该问题。

错误2：类型不匹配（List 不是 List 的子类型） #

原因：Hive在读取自定义类型数据时，即使声明了Box的泛型为List<ProjectModal>，如果没有正确注册类型适配器，或者没有显式做类型转换，读取到的列表会被推断为List<dynamic>，无法直接赋值给List<ProjectModal>类型的变量。

• 第一步：确认自定义类型的Adapter配置正确
  检查ProjectModal和LoggedInUser类是否添加了Hive注解、生成了适配器，并且在main函数初始化Hive后完成注册：

// 模型类示例
@HiveType(typeId: 0) // 确保typeId全局唯一
class ProjectModal extends HiveObject {
  @HiveField(0)
  String? id;
  // 其他字段...
  static const String boxID = 'project_box';
}
// main函数中注册
void main() async {
  await Hive.initFlutter();
  Hive.registerAdapter(ProjectModalAdapter());
  Hive.registerAdapter(LoggedInUserAdapter());
  await Hive.openBox<List<ProjectModal>>(ProjectModal.boxID);
  await Hive.openBox<LoggedInUser>(LoggedInUser.boxID);
  runApp(const MyApp());
}

• 第二步：优化Hive读写逻辑，建议用固定Key存取数据，避免用.values.first的不稳定写法
  存数据时指定固定Key，读数据时用get方法指定默认值，同时做显式类型转换：

Future<void> getHiveBox() async {
  userBox = Hive.box<LoggedInUser>(LoggedInUser.boxID);
  projectBox = Hive.box<List<ProjectModal>>(ProjectModal.boxID);

  // 用固定key读数据，默认返回空列表
  final List? boxData = projectBox.get('projects');
  List<ProjectModal> first = [];
  if (boxData != null && boxData.isNotEmpty) {
    // 显式做类型转换
    first = boxData.cast<ProjectModal>();
  }

  if (first.isEmpty) {
    print('项目列表为空');
    await getProjectsList();
  } else {
    print('检测到项目列表\n${first.length}');
    setState(() {
      projectList = first;
    });
  }
}

Future<void> getProjectsList() async {
  SchedulerBinding.instance?.addPostFrameCallback((_){  
    _indicatorKey.currentState?.show(); 
  });
  WebServices webServices = WebServices(URLs.projectList());
  var data = await webServices.get(isV1: false);
  var projectListData = ProjectModal.getProjectsList(data);
  // 拉取到数据后写入Hive
  await projectBox.put('projects', projectListData);
  setState(() {
    isLoading = false;
    projectList = projectListData;
  });
}

• 第三步：如果仍有类型转换问题，可以先清空应用缓存卸载重装，避免之前写入的旧格式数据影响读取。

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