Flutter使用Hive调用registerAdapter报null错误如何解决？

错误根源 #

报错核心原因是操作符优先级导致Hive初始化逻辑执行顺序错误：
Hive.initFlutter()返回的是Future<void>类型，你直接在后面加级联运算符..，相当于对尚未完成初始化的Future对象调用registerAdapter和openBox方法，而非对已初始化完成的Hive实例调用，自然会报方法调用在null上的错误。

解决方案 #

把级联调用拆开，按顺序等待每一步异步操作执行完成后再执行下一步：

1. 先await执行Hive.initFlutter()完成初始化
2. 调用Hive的registerAdapter方法注册你生成的UserAdapter
3. 再await执行openBox操作打开需要用的Box

修正后的main.dart代码 #

import 'package:flutter/material.dart';
import 'package:hive/hive.dart';
import 'package:hive_flutter/hive_flutter.dart';

import 'constants.dart';
import 'controllers/navigation_controller.dart';
import 'models/User.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 第一步：完成Hive初始化
  await Hive.initFlutter();
  // 第二步：注册适配器
  Hive.registerAdapter(UserAdapter());
  // 第三步：打开所需Box
  await Hive.openBox('user');

  runApp(MyApp());
}

补充排查项 #

如果修改后仍有异常，可执行以下操作：

• 确认hive、hive_flutter核心库版本和hive_generator 1.1.0版本匹配，建议核心库使用2.0.x以上版本
• 执行flutter packages pub run build_runner build --delete-conflicting-outputs重新生成适配器文件，清除旧的缓存生成代码

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