Google Apps Script setValues随机失效问题排查及解决

问题背景 #

2016年曾有用户反馈类似问题仅在调试模式出现，但本次问题同时出现在线上Web应用后端及调试环境中。奇怪的是，并非所有setValues调用都会失败——脚本靠前位置的数组setValues调用能正常写入表格。代码已超过一个月未修改，10月26日前运行完全正常，首次故障报告提交于11月2日。

示例代码 #

function setValuesIsFailing(sheet, array, row, column){
//newIDR_SHEET.getRange(3, 9, formulaColumns.length, 2).setValues(formulaColumns);//old command this function replaces

const targetRange = sheet.getRange(row,column,array.length,array[0].length);
console.log(139,targetRange.getA1Notation());
sheet.getRange("C5").setValue("UGH");
targetRange.setValues(array);
console.log(sheet.getRange("C5").getValue());
}

运行日志输出 #

10:46:10 AM Info    139 'I3:J49'
10:46:11 AM Error   
Exception: Service Spreadsheets failed while accessing document with id 12shsTE-Mxxx

setValuesIsFailing  @ Code.gs:143

日志第139行显示脚本已成功获取目标工作表范围，但写入操作无报错却未生效，后续读取该位置时触发了Spreadsheets服务错误。

问题特征 #

• 代码曾长期正常运行，近一个月未修改，多数时间仍能正常执行
• setValue/setValues调用静默失败：无报错提示，但数据未写入表格
• 读取未被修改的目标位置时，触发Spreadsheets服务错误
• 将故障代码迁移至新函数后，问题依旧存在

已尝试的排查操作 #

• 记录并确认工作表名称正确性
• 重新赋值工作表变量
• 将故障代码移至新函数，便于日志追踪
• 等待系统自行恢复

问题原因与解决方法 #

异常根源在于数据验证设置失败。此前逐列拉取表格数据验证规则时，系统可能接受单列二维数组或自动扁平化数组，但该逻辑已发生变更。手动使用.flat()方法扁平化列数据后，问题完全解决。遗憾的是，错误的数据验证设置并未触发明确的报错提示，增加了排查难度。

内容的提问来源于stack exchange，提问作者J. G.