Flutter应用中Hive Box检索/打开报错问题求助

我正在做一个项目，需要用Hive数据库存储用户交易信息，字段如下（除2项外均由用户输入）：

• _userID（Firebase生成的uid）
• amount（交易金额-用户输入）
• type（下拉框选择值-用户输入）
• categoryValue（下拉框选择值-用户输入）
• DescriptionValue（用户输入字符串）
• DateTime（DateTime.now()自动生成）

相关代码如下：

触发交易保存的按钮代码 #

OutlinedButton(
  onPressed: () {
     saveTransaction(
       _userID,
       amount,
       type,
       categoryValue,
       descriptionValue,
       DateTime.now(),
     );

Hive初始化与交易保存函数（单独Dart文件） #

void main() async {
  await Hive.initFlutter();
  Hive.registerAdapter(TransactionModelAdapter());
}

void saveTransaction(String userId, double amount, String type, String category, String description, DateTime dateTime) async {
  // Open the Hive box for transactions
  final transactionsBox = await Hive.openBox<TransactionModel>('transactions');

  // Create a new transaction object
  final transaction = TransactionModel()
    ..userId = userId
    ..amount = amount
    ..type = type
    ..category = category
    ..description = description
    ..dateTime = dateTime;

  // Save the transaction to the box
  await transactionsBox.add(transaction);
}

TransactionModel模型类（单独Dart文件） #

import 'package:hive/hive.dart';

part 'transaction_model.g.dart'; // Generated file name

@HiveType(typeId: 0) // HiveType annotation with typeId
class TransactionModel extends HiveObject {
  @HiveField(0) // HiveField annotation with index
  late String userId; // Unique user ID associated with the transaction

  @HiveField(1) // HiveField annotation with index
  late double amount;

  @HiveField(2)
  late String type; // Type of transaction (e.g., expense, income)

  @HiveField(3)
  late String category; // Category of the transaction

  @HiveField(4)
  late String description; // Description of the transaction

  @HiveField(5)
  late DateTime dateTime; // Date and time of the transaction
}

测试页面代码（报错出现处） #

void main() async {
  runApp(transactionApp());
  Hive.registerAdapter(TransactionModelAdapter());
  await Hive.initFlutter();
}

class transactionApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: AllTransactionsPage(),
    );
  }
}

class AllTransactionsPage extends StatefulWidget {
  @override
  _AllTransactionsPageState createState() => _AllTransactionsPageState();
}

class _AllTransactionsPageState extends State<AllTransactionsPage> {
  late Box<TransactionModel> transact_box;

  @override
  void initState() {
    super.initState();
    _openBox();
  }

  Future<void> _openBox() async {
    transact_box = await Hive.openBox<TransactionModel>('transactions');
    setState(() {}); // Trigger rebuild after box is initialized
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('All Transactions Page'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            // Button onPressed action
            print('Button Pressed');
            print("Number of entries are ${transact_box.length}");
          },
          child: Text('Press Me'),
        ),
      ),
    );
  }
}

错误情况 #

点击测试页面按钮时，出现Hive Box检索或打开错误，错误信息如下：

解决方案 #

1. 修正测试页面的Hive初始化顺序 #

测试页面main函数的执行顺序错误，必须先初始化Hive、注册适配器，再运行App。修改后的代码：

void main() async {
  await Hive.initFlutter(); // 第一步：初始化Hive
  Hive.registerAdapter(TransactionModelAdapter()); // 第二步：注册模型适配器
  runApp(transactionApp()); // 第三步：启动应用
}

2. 确保Box初始化完成后再访问 #

即使调用了setState，仍可能存在Box未完成初始化就被点击访问的情况，添加状态判断：

@override
Widget build(BuildContext context) {
  return Scaffold(
    appBar: AppBar(
      title: Text('All Transactions Page'),
    ),
    body: Center(
      // 判断Box是否已打开
      child: transact_box.isOpen 
          ? ElevatedButton(
              onPressed: () {
                print('Button Pressed');
                print("Number of entries are ${transact_box.length}");
              },
              child: Text('Press Me'),
            )
          : CircularProgressIndicator(), // 未初始化时显示加载动画
    ),
  );
}

3. 检查适配器文件是否生成 #

确保已通过build_runner生成transaction_model.g.dart文件，执行以下命令生成：

flutter packages pub run build_runner build

4. 统一全局初始化逻辑 #

建议将Hive初始化逻辑统一放在项目根入口main.dart中，避免多页面重复初始化引发冲突。

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