Flutter HiveDB调用delete方法未真正删除数据引发空值报错问题

问题根因 #

• Hive默认使用自增int作为存储key时，delete()方法为了优化IO性能，仅会标记对应位置为已删除，不会主动重排索引清理空位，因此会遗留null占位，此时直接通过索引访问Box会拿到null值。
• 代码核心错误为：ListView的索引与Box的存储key不匹配：itemCount取的是_sal.values.length（已过滤null后的有效数据长度），但itemBuilder中直接用_sal.get(index)将ListView索引当作Box的存储key访问，已删除的key位置就会返回null，强制解包!就触发崩溃。

修复方案 #

1. 快速修复ListView取值逻辑 #

直接使用Box.values的元素构建列表，不要通过索引访问Box本身，同时删除时拿到对应元素的真实key执行删除：

late Box<Sal> _sal;
useEffect((){
  _sal = Hive.box<Sal>('sal') ;
});

// ...
ValueListenableBuilder(
  valueListenable: _sal.listenable(),
  builder: (_, Box<Sal> sal, __) {
    // 提前拿到所有有效数据的key和value对应列表
    final salList = sal.values.toList();
    final salKeys = sal.keys.toList();
    return ListView.builder(
      physics: const NeverScrollableScrollPhysics(),
      shrinkWrap: true,
      padding: EdgeInsets.zero,
      itemBuilder: (context, index) {
        final currentSal = salList[index];
        final currentKey = salKeys[index];
        return Container(
          height: 50.0,
          margin: EdgeInsets.symmetric(vertical: 0.0),
          child: Card(
            color: DefaultColors.$lightBrown,
            child: Row(
              children: [
                CText(
                  text: currentSal.salName,
                  color: Colors.white,
                  style: AppTheme.of(context).thinCaption(),
                ).pOnly(right: 16.0),
                const Spacer(),
                IconButton(
                  icon: Icon(
                    Icons.edit,
                    color: Colors.yellow,
                  ),
                  onPressed: () => showGeneralDialog(
                    //...
                  ),
                ),
                IconButton(
                  icon: Icon(
                    Icons.delete,
                    color: Colors.white,
                  ),
                  onPressed: () async {
                    // 用真实存储key删除，不要用index
                    await _sal.delete(currentKey);
                    // 可选：如果需要索引和key长期一一对应，批量删除后调用compact
                    // await _sal.compact();
                  },
                ),
              ],
            ),
          ),
        );
      },
      itemCount: salList.length,
    );
  }
).pSymmetric(
  h: 16,
),

2. 彻底解决空占位问题 #

如果需要保证Box的存储key与索引始终一一对应，可选择以下任意一种方案：

• 批量删除后调用_sal.compact()方法，Hive会自动清理所有已删除的空位，重排索引。注意不要单条删除后就调用，会产生额外IO开销。
• 存储数据时不使用默认自增key的add()方法，改用put()方法传入自定义唯一key（比如Sal对象的业务id），删除时直接传入对应业务key执行删除，不会产生空占位，也不会出现索引与key不匹配的问题。

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