Google Apps Script存储2D数组至ScriptProperties时Invalid argument问题排查
报错核心原因定位
1. 触发Invalid argument的直接问题
这个错误和JSON.stringify的使用方式没有关系,问题出在setProperties的传参逻辑上:
- Apps Script里
PropertiesService的setProperties()方法,要求入参必须是「属性名-属性值」组成的键值对对象,不接受纯字符串作为入参。 - 你现在直接把序列化后的JSON字符串
xColAarr整个传给setProperties,方法会尝试把传入的字符串逐字符拆解为属性名,完全无法识别合法的属性配置,自然抛出无效参数错误。 - 你对"Property Store仅支持存字符串类型值"的理解是正确的——存储的所有值最终都会被转为字符串,但字符串必须作为某个自定义属性名对应的value存在,不能直接当整个方法的入参。
2. 修正后的存储代码
把序列化后的数组字符串,作为值绑定到你自定义的属性名下即可,对应代码调整:
// 原有数组构造逻辑保持不变 ColAarr.push([shtData[2][1]]); const ScriptProperties = PropertiesService.getScriptProperties(); const xColAarr = JSON.stringify(ColAarr); Logger.log(xColAarr); // 正确传参:构造键值对对象,把序列化后的字符串存到名为xColAarr的属性下 ScriptProperties.setProperties({ "xColAarr": xColAarr });
3. 后续数组恢复阶段的潜在错误
你准备用来写回表格的代码,还存在一个会导致写入失败的结构问题:
JSON.parse(ScriptProperties.getProperty('xColAarr'))解析出来的本身就是和存储时完全一致的二维数组(结构为[["Train Station"],["Train Station"],["Bus Station"]]),你在外面额外套了一层方括号再push进ColAarr,会把数组变成三维结构,和setValues要求的二维入参格式不匹配,最终会触发范围大小不匹配的报错。- 修正后的恢复+写入代码:
// 直接取出属性值解析为二维数组,不需要额外套层 const savedColAarr = JSON.parse(ScriptProperties.getProperty('xColAarr')); // 按解析后的数组长度计算写入范围,直接传入setValues const endRow = GlobLastRow + savedColAarr.length - 1; ResultFile.getRange(`A${GlobLastRow}:A${endRow}`).setValues(savedColAarr); // 清理属性的逻辑保持不变 ScriptProperties.deleteAllProperties();
注意事项
- ScriptProperties单属性值的存储上限为9KB,如果你的ColAarr长度过长,要注意超限问题;数组规模较大的场景可以考虑用临时Drive文件做中间存储。
内容的提问来源于stack exchange,提问作者Glib Gibon
相关产品推荐
相关产品推荐

