Flutter中FutureBuilder搭配Isar DB数据更新后无法即时刷新问题

1. FutureBuilder缓存机制导致未重新请求数据 #

FutureBuilder会缓存初始化时传入的Future实例，单纯调用setState()并不会触发它重新执行getAllItems()——因为它判断Future实例没有变化，就直接复用之前的快照数据。

解决方法：用状态变量存储Future，每次需要刷新时重新创建Future实例：

late Future<List<Item>> _itemsFuture;

@override
void initState() {
  super.initState();
  _itemsFuture = _getAllItems();
}

Future<List<Item>> _getAllItems() async {
  return await isar.items.where().findAll();
}

void _refreshList() {
  setState(() {
    _itemsFuture = _getAllItems(); // 重新创建Future，触发FutureBuilder重新查询
  });
}

// 使用FutureBuilder时绑定状态变量
FutureBuilder(
  future: _itemsFuture,
  builder: (context, snapshot) {
    // 列表UI构建逻辑
  },
)

2. 页面返回时未确保数据库操作完全完成 #

如果编辑页执行数据库操作后直接Navigator.pop()，可能存在写事务还未真正落地的延迟（即使写了await，Isar的事务提交也可能有极短的异步处理时间）。

解决方法：确认事务完成后再返回，原页面通过then回调触发刷新：

// 编辑页提交修改逻辑
await isar.writeTxn((isar) async {
  await isar.items.put(updatedItem);
});
// 确保事务完成后再返回页面
Navigator.pop(context, true);

// 原页面跳转编辑页的代码
Navigator.push(context, MaterialPageRoute(builder: (_) => EditItemPage(item: item)))
  .then((isUpdated) {
    if (isUpdated == true) {
      _refreshList(); // 此时数据库操作已完成，直接刷新即可
    }
  });

3. 改用Isar监听机制实现自动刷新 #

Isar原生支持监听集合数据变化，用StreamBuilder替代FutureBuilder可以彻底避免手动刷新的时机问题：

StreamBuilder<List<Item>>(
  // watchLazy()会在集合有增删改时自动触发刷新
  stream: isar.items.watchLazy(),
  builder: (context, snapshot) {
    if (!snapshot.hasData) {
      return const Center(child: CircularProgressIndicator());
    }
    final items = snapshot.data!;
    return ListView.builder(
      itemCount: items.length,
      itemBuilder: (context, index) {
        final item = items[index];
        return ListTile(
          title: Text(item.name),
          onTap: () => Navigator.push(context, MaterialPageRoute(builder: (_) => EditItemPage(item: item))),
        );
      },
    );
  },
)

这种方式下，数据库中Item集合的任何变化都会自动同步到UI，无需手动调用setState()。

4. 检查Isar实例的一致性 #

确保整个应用使用同一个Isar实例，避免多实例导致的数据不同步：

class IsarService {
  static Isar? _instance;

  static Isar get instance {
    if (_instance == null) {
      throw StateError("Isar未初始化");
    }
    return _instance!;
  }

  static Future<void> init() async {
    if (_instance == null) {
      _instance = await Isar.open(
        schemas: [ItemSchema],
        directory: await getApplicationDocumentsDirectory(),
      );
    }
  }
}

所有数据库操作都通过IsarService.instance调用，保证读写的是同一个数据库文件。

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