PropertiesService是否内置超长字符串检测？存储溢出问题咨询

一段稳定运行的代码突然故障，生成畸形HTML，排查发现Script PropertiesService中存储的对象内容溢出到其他存储槽，问题关联savegobjScriptProperties函数。前端生成代码如下：

function getgobjHtml() {
  let obj = gobj.globals;
  let gn = 0;
  let sn = 0;
  let html = '';
  html += '<table><tr><th>Property</th><th>Value</th></tr>';
  html += '<tr><th>gobj.globals</th><th>From Globals</th></tr>'
  for (let p in obj) {
    html += Utilities.formatString('<tr><td><textarea id="gp%s">%s</textarea></td><td><textarea id="gv%s">%s</textarea></td></tr>', gn, p, gn++, obj[p]);
  }
  html += Utilities.formatString('<tr><td><textarea id="gp%s"></textarea></td><td><textarea id="gv%s"></textarea></td></tr>', gn, gn++);
  html += '</table>';
  html += Utilities.formatString('<br /><input type="button" value="Save Global Properties" onClick="savegobjGlobalProperties(%s);" />',gn);
  html += '<div id="gmsg"></div>';
  html += '<table><tr><th>Property</th><th>Value</th></tr>';
  html += '<tr><th>gobj.init</th><th>From Script Properties</th></tr>'
  obj = gobj.init;
  for (let p in obj) {
    html += Utilities.formatString('<tr><td><textarea id="sp%s">%s</textarea></td><td><textarea id="sv%s">%s</textarea></td></tr>', sn, p, sn++, obj[p]);
  }
  html += Utilities.formatString('<tr><td><textarea id="sp%s"></textarea></td><td><textarea id="sv%s"></textarea></td></tr>', sn, sn++);
  html += '</table>';
  html += Utilities.formatString('<br /><input type="button" value="Save Script Properties" onClick="savegobjScriptProperties(%s);" />',sn);
  html += '<div id="smsg"></div>';
  html += '<br /><br /><input type="button" value="Close" onClick="google.script.host.close();" />';
  return HtmlService.createHtmlOutput(html).getContent();
}

经检查，序列化后的对象长度达390,113字符，超出Properties Service和Cache Service的存储限制：

• Properties Service单值最大限制9KB，总存储上限500KB
• Cache Service单缓存键值最大100KB，键名最长250字符，过期时间最长6小时（可能提前被清理）

Cache Service存储超量数据时会给出警告，但Properties Service无任何提示，导致误以为存储成功。

现咨询：

1. PropertiesService是否内置超长字符串检测机制？
2. 如何避免存储对象溢出的问题？

解答 #

关于PropertiesService的超长字符串检测机制 #

PropertiesService没有内置的超长字符串检测或报错机制，当存储的字符串超过单值9KB限制时，它会静默截断内容，不会抛出任何异常或给出警告。这就是你遇到内容溢出到其他存储槽的核心原因——截断后的不完整数据破坏了对象结构，导致读取时解析异常，进而干扰后续存储或读取操作。

避免存储对象溢出的解决方案 #

1. 拆分大对象为多个小属性存储

将大对象按模块、数据类型拆分，拆分为多个独立键值对，确保每个值的长度控制在9KB以内：

// 拆分存储大对象
function splitAndSaveLargeObj(largeObj) {
  const propService = PropertiesService.getScriptProperties();
  // 按数据模块拆分
  const basicInfo = JSON.stringify({ name: largeObj.name, id: largeObj.id });
  const detailData = JSON.stringify({ logs: largeObj.logs, records: largeObj.records });
  // 分别存储
  propService.setProperty('obj_basic', basicInfo);
  propService.setProperty('obj_detail', detailData);
}

// 读取时合并对象
function getMergedObj() {
  const propService = PropertiesService.getScriptProperties();
  const basicInfo = JSON.parse(propService.getProperty('obj_basic'));
  const detailData = JSON.parse(propService.getProperty('obj_detail'));
  return { ...basicInfo, ...detailData };
}

2. 压缩序列化后的字符串

使用Google Apps Script的工具类对字符串进行压缩，减少存储长度：

// 压缩存储大对象
function saveCompressedObj(key, obj) {
  const propService = PropertiesService.getScriptProperties();
  const jsonStr = JSON.stringify(obj);
  // 将字符串转为Blob并压缩
  const compressedBlob = Utilities.newBlob(jsonStr).getAs('application/zip');
  const encodedStr = Utilities.base64Encode(compressedBlob.getBytes());
  // 存储压缩后的base64字符串
  propService.setProperty(key, encodedStr);
}

// 解压读取对象
function getCompressedObj(key) {
  const propService = PropertiesService.getScriptProperties();
  const encodedStr = propService.getProperty(key);
  if (!encodedStr) return null;
  const bytes = Utilities.base64Decode(encodedStr);
  const uncompressedBlob = Utilities.unzip(Utilities.newBlob(bytes, 'application/zip'))[0];
  return JSON.parse(uncompressedBlob.getDataAsString());
}

如果压缩后仍超过9KB，建议结合拆分方法使用。

3. 替换存储方案

若数据量持续增长，PropertiesService的限制无法满足需求，可选择更适合的存储方式：

• Google Sheets：将结构化数据存储在隐藏工作表中，适合需要持久化的中等规模数据
• Google Drive文件：将对象序列化为JSON文件存储在Drive，支持超大对象存储
• Firebase Realtime Database：适合频繁读写、需要更大容量的场景

4. 添加前置长度校验

在存储前主动检查序列化后的字符串长度，提前拦截超量数据，避免静默截断：

function saveObjWithValidation(key, obj) {
  const propService = PropertiesService.getScriptProperties();
  const jsonStr = JSON.stringify(obj);
  const maxSingleValueSize = 9 * 1024; // 9KB

  if (jsonStr.length > maxSingleValueSize) {
    throw new Error(`存储内容超出单值限制：当前长度${jsonStr.length}字节，最大允许${maxSingleValueSize}字节`);
    // 此处可自动触发拆分/压缩逻辑替代抛出异常
  }
  propService.setProperty(key, jsonStr);
}

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