Google Apps Script 函数调用时序异常：CSV导入后排序填充公式失效

问题根因 #

你遇到的问题是Google Apps Script针对电子表格操作的延迟写入（批量缓存）机制导致的：

• 所有对Spreadsheet的修改操作（比如setValues）默认不会立刻同步到Google云端服务器，会先存在本地缓存队列里，等脚本执行到空闲阶段或者队列满了才批量提交，减少API调用次数提升性能。
• 你在脚本里连续调用setValues和UpdateComplete时，UpdateComplete里读取的getLastRow、getRange("K1:K").getValues()获取的还是修改前的旧数据，此时新增行还没实际写入到表格里，所以公式填充失效。
• 手动分步执行时，两个函数分别在两次独立的脚本运行实例里执行，前一个函数运行结束后缓存里的更改会全部提交完成，后一个函数读到的就是最新的写入结果，所以功能正常。Utilities.Sleep只暂停脚本运行，不会触发缓存提交，因此无法解决问题。

解决方案 #

只需要在setValues执行后、调用UpdateComplete之前，添加一行SpreadsheetApp.flush()即可，这个API的作用就是强制把当前所有未提交的电子表格修改立刻同步到云端，确保后续读操作拿到的是最新数据。

修改后的代码 #

function RetrieveAwardData(){
  var threads = GmailApp.search('is:unread subject:VA Benefit Aid');
  var message = GmailApp.getMessagesForThreads(threads); //retrieve all messages in the specified threads.
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('AwardData');
  
  if(message[0] != null){
    Logger.log(message[0]);
    for (var i = 0 ; i < message.length; i++) {
      for (var j = 0; j < message[i].length; j++) {
        var attachment = message[i][j].getAttachments()[0];
        var csvData = Utilities.parseCsv(attachment.getDataAsString('ISO-8859-1'), ",");
        
        sheet.getRange(1, 1, csvData.length, csvData[0].length).setValues(csvData);
        // 新增强制刷新，确保CSV写入完成后再执行后续逻辑
        SpreadsheetApp.flush();
        
        UpdateComplete();
        
        GmailApp.markMessageRead(message[i][j]);
      }
    }
  }
  else{Logger.log("No file available.");}
}

function UpdateComplete(){
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheetByName('AwardData');
  sheet.sort(11);
  var LastAwardRow = sheet.getLastRow();
  var Avals = ss.getRange("K1:K").getValues();
  var LastCompleteRow = Avals.filter(String).length;
  
  if(LastAwardRow != LastCompleteRow){  
    sheet.getRange("K"+(LastCompleteRow+1) + ":K" + LastAwardRow).setFormulaR1C1(sheet.getRange("K"+LastCompleteRow).getFormulaR1C1());
  }

}

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