Flutter gSheets API技术问询：如何在表格中批量插入/追加多行

我看了你的代码，发现几个可能导致多行数据无法写入Google Sheets的问题，咱们一步步来解决：

问题1：insert方法未正确处理异步操作且未触发实际写入 #

你的UserSheetsApi.insert方法是同步的，但gsheets库的表格写入操作是异步的，而且values.map.appendRows只是把数据添加到本地缓冲区，并没有立即发送到Google Sheets服务器。你需要：

• 把insert改成异步方法
• 在添加行后调用flush()来提交缓冲区的数据到服务器

修改后的UserSheetsApi.dart的insert方法：

static Future insert(List<Map<String, dynamic>> rowList) async {
  await _userSheet!.values.map.appendRows(rowList);
  // 提交缓冲区的数据到Google Sheets
  await _userSheet!.values.map.flush();
}

问题2：循环中多次调用insert效率低且可能导致竞态 #

你现在在循环里每次只传一个元素的列表调用insert，这样会触发多次网络请求，而且可能因为异步操作的顺序问题导致数据丢失。更好的做法是先把所有要插入的数据收集到一个列表里，然后一次性调用insert：

修改后的home.dart代码片段：

// 先收集所有要插入的数据
List<Map<String, dynamic>> allRows = [];
for (var i = 0; i < gsIndex; i++) {
  Map<String, dynamic> pStatus = {
    ParadeState.rank : usersList[i]['RANK'],
    ParadeState.name : usersList[i]['NAME'],
    ParadeState.morningState : dropdownAMValue,
    ParadeState.afternoonState : dropdownPMValue,
    ParadeState.date : formatted,
  };
  print(pStatus);
  allRows.add(pStatus);
}
// 一次性插入所有行
await UserSheetsApi.insert(allRows);

额外检查点 #

• 确保ParadeState.getPS()返回的表头和你插入的pStatus的键完全匹配（大小写、拼写都要一致），否则gsheets的map映射会找不到对应的列，导致数据无法写入。
• 检查你的Google Sheets权限是否正确，确保服务账号有编辑该表格的权限。
• 可以在insert方法里添加错误捕获，方便排查问题：

static Future insert(List<Map<String, dynamic>> rowList) async {
  try {
    await _userSheet!.values.map.appendRows(rowList);
    await _userSheet!.values.map.flush();
    print('数据写入成功');
  } catch (e) {
    print('写入错误: $e');
  }
}

这样修改后，应该就能成功一次性插入多行数据到Google Sheets了。

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