调用Document Properties时触发Invalid ID错误的排查求助

问题详情 #

我的应用调用Document Properties时返回错误：Exception: Invalid ID [line: 3, function: viewRecord, file:，报错行是获取Document Properties的代码。此前仅在应用另一处调用该功能运行正常，但编写以下代码后，该功能随之失效：

function viewRecord() {
  const properties = PropertiesService.getUserProperties();
  const dProperties = PropertiesService.getDocumentProperties();
  const record = JSON.parse(dProperties.getProperty("linked_record"));
  if (record !== null && record !== undefined) {
    const url = `${properties.getProperty("instance_url")}/${record.ViewPage}`
    return CardService.newTextButton()
      .setText("View")
      .setOpenLink(
        CardService.newOpenLink()
          .setUrl(url)
          .setOpenAs(CardService.OpenAs.OVERLAY)
          .setOnClose(CardService.OnClose.NOTHING)
      );
  }
  return CardService.newTextButton()
    .setText("View")
    .setOnClickAction(
      CardService.newAction().setFunctionName("viewRecordError")
    );
}

已尝试以下操作但问题仍存在：

• 删除了上述代码，另一处调用Document Properties的区域依旧报错
• 清空应用内所有属性，错误未消失

错误成因分析 #

PropertiesService.getDocumentProperties()报错“Invalid ID”，核心原因是当前脚本的运行上下文无法关联到有效的Google文档/表格/幻灯片实例，具体包括以下几种情况：

1. 脚本类型不匹配
   Document Properties是容器绑定脚本专属的功能，仅能在绑定到Google Docs/Sheets/Slides的脚本中使用。如果你的脚本是独立脚本（未绑定任何文档，直接在脚本编辑器创建的独立项目），调用该方法会直接抛出“Invalid ID”错误。此前功能正常，说明原来的代码是在容器绑定脚本中运行，后续修改可能导致脚本脱离了绑定上下文。

2. 文档关联失效
   即使是容器绑定脚本，如果绑定的文档被删除、权限变更（比如你失去了文档的编辑权限），或者脚本的绑定关系意外中断，调用getDocumentProperties()时也会因为无法找到有效的文档ID而报错。

3. 运行上下文残留问题
   即使删除了报错代码、清空了属性，脚本的运行缓存或上下文可能残留了错误的绑定信息，导致后续调用仍触发同样的错误。

解决建议 #

• 确认脚本类型：确保脚本是容器绑定脚本——打开目标Google文档/表格/幻灯片，通过「工具 > 脚本编辑器」创建或打开脚本项目，不要使用独立脚本。
• 验证文档有效性：检查绑定的文档是否存在、你是否拥有编辑权限，确认文档ID（从URL中提取，格式如https://docs.google.com/document/d/[文档ID]/edit）有效。
• 重建绑定脚本：如果原脚本绑定关系异常，尝试在目标文档中重新创建脚本项目，迁移代码后再测试。
• 检查触发方式：确保调用getDocumentProperties()的代码是通过文档的自定义菜单、触发器或卡片操作触发，避免在脚本编辑器中直接运行独立函数（这种方式可能脱离文档上下文）。

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