Flutter离线Todo应用联网后如何同步Hive数据至Google Sheets

DevOps 小满

2026-8-11

解决Hive数据批量推送到Google Sheets的问题

核心问题分析与修复方案

问题根源：仅推送第一条数据通常是因为遍历Hive数据时逻辑错误，或是异步推送请求未正确处理导致后续数据未发送。

1. 完整遍历Hive存储的所有数据

确保你没有只获取第一条数据，而是遍历整个Hive Box的内容：

// 正确遍历所有待办项
final todoBox = Hive.box('todos');
// 遍历box中所有值
for (final todo in todoBox.values) {
  // 调用推送方法发送当前todo
  await _pushToGoogleSheets(todo);
}

2. 异步请求需逐个等待完成

如果推送是异步操作，循环中必须用await等待每条请求完成，否则可能因并发问题导致仅第一条成功：

Future<void> syncAllTodos() async {
  final todoBox = Hive.box('todos');
  
  for (final todo in todoBox.values) {
    try {
      // 等待当前todo推送完成再处理下一条
      await _sendToSheets(todo);
      // 可选：标记已同步，避免重复推送
      todo.isSynced = true;
      await todo.save();
    } catch (e) {
      print('推送失败: $e');
    }
  }
}

3. 优先使用批量推送接口

如果Google Sheets支持批量提交，将所有待办数据打包发送能提升效率并避免单条循环的问题：

Future<void> batchSyncTodos() async {
  final todoBox = Hive.box('todos');
  // 将所有待办项转为可序列化的列表
  final todosList = todoBox.values.map((todo) => todo.toJson()).toList();
  
  try {
    await http.post(
      Uri.parse('你的Google Sheets接口URL'),
      body: jsonEncode({'data': todosList}),
      headers: {'Content-Type': 'application/json'},
    );
    // 批量成功后统一标记已同步
    for (final todo in todoBox.values) {
      todo.isSynced = true;
      await todo.save();
    }
  } catch (e) {
    print('批量推送失败: $e');
  }
}