Google Sheets脚本批量导出PDF时单元格变更不生效问题求助

你遇到的问题核心是：Google Apps Script的电子表格操作默认采用批量缓存机制——所有单元格修改会先暂存在内存中，等整个脚本执行完毕后才一次性同步到云端。而你通过UrlFetchApp调用PDF导出接口时，访问的是云端存储的表格数据，此时循环内的单元格变更还没提交，所以每次导出的都是脚本启动前的初始状态。

直接解决办法：强制同步单元格变更 #

在每次修改单元格后、发起PDF导出请求前，调用SpreadsheetApp.flush()方法，强制将内存中的修改立即同步到云端。

修改后的完整代码如下：

function save_pdfs()
{
  var spreadsheet = SpreadsheetApp.getActive();
  var sheet       = spreadsheet.getSheetByName("sheet1");

  var ss_id = spreadsheet.getId();
  var s_id  = sheet.getSheetId();

  var folders = DriveApp.getFoldersByName("dummy_folder");
  var folder  = folders.next();

  for (var i = 0; i < 3; ++i)
  {
    sheet.getRange(1,1,1,1).setValue(i);
    // 关键：强制同步单元格变更到云端
    SpreadsheetApp.flush();

    const url = "https://docs.google.com/spreadsheets/d/" + ss_id + "/export" +
    "?format=pdf&" +
    "size=a4&" +
    "scale=2&" +
    "fzr=true&" + 
    "portrait=true&" +
    "gridlines=false&" +
    "printtitle=false&" +
    "top_margin=0.2&" +
    "bottom_margin=0.2&" +
    "left_margin=0.2&" +
    "right_margin=0.2&" +
    "sheetnames=false&" +
    "pagenum=UNDEFINED&" +
    "attachment=true&" +
    "gid=" + s_id;

    const params = { method: "GET", headers: { "authorization": "Bearer " + ScriptApp.getOAuthToken() } };
    const blob = UrlFetchApp.fetch(url, params).getBlob().setName("dummy" + i + ".pdf");

    folder.createFile(blob);
  }
};

补充说明 #

• flush()会立即执行所有待处理的电子表格操作，确保云端数据与脚本内的修改完全一致。
• 如果你的循环次数极多（比如上百次），频繁调用flush()可能会增加脚本执行时间，需注意Google Apps Script的单次执行超时限制（最长6分钟）。这种场景下可以改用临时文件方案：每次循环复制一份模板表格到临时文件，修改临时文件的单元格后导出PDF，最后删除临时文件。该方式虽稍繁琐，但能彻底避免缓存同步问题，且不受flush()的性能影响。

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