Google Apps Script报错TypeError: Cannot read property 'getBody' of null求助

问题重现 #

运行以下代码时触发错误：

function myFunction(){
  //application//file
  var ad = DocumentApp.getActiveDocument();
  var docBody = ad.getBody () ;
  var paragraphs = docBody.getParagraphs();
  //paragraphs[0]. setText ("MY NEW TEXT"): 
  //var attr = paragraphs[0].getAttributes() ;
  //Logger.log(attr);
  paragraphs[0].setAttributes({FONT_SIZE:40});
}

错误信息：

TypeError: Cannot read property 'getBody' of null
myFunction @ Code.gs:5

已打开Google文档并授权脚本权限，仍报错。

错误原因 #

DocumentApp.getActiveDocument()仅能获取当前与脚本绑定的活跃Google文档，但必须满足以下场景才会返回有效对象：

• 脚本是从目标Google文档内部创建的绑定脚本（而非独立的脚本项目）；
• 脚本通过文档内的自定义菜单、触发器触发运行，而非直接在脚本编辑器点击「运行」按钮（独立脚本或绑定脚本直接点运行时，无活跃文档上下文）。

如果你的脚本是独立项目（比如直接在script.google.com创建），或者在绑定脚本里直接点运行，getActiveDocument()会返回null，调用getBody()时就会触发报错。

解决方法 #

方法1：使用绑定脚本并通过文档菜单触发 #

1. 打开目标Google文档；
2. 点击顶部菜单「扩展程序」→「Apps Script」，创建绑定到该文档的脚本项目；
3. 将代码粘贴到绑定脚本中；
4. 添加自定义菜单代码，方便从文档内触发：

   function onOpen() {
     DocumentApp.getUi().createMenu('自定义操作')
       .addItem('修改段落字体', 'myFunction')
       .addToUi();
   }
   

5. 保存脚本后刷新文档，顶部会出现「自定义操作」菜单，点击对应选项即可正常运行代码。

方法2：在独立脚本中通过ID/URL打开文档 #

如果必须使用独立脚本，替换getActiveDocument()为openById或openByUrl：

function myFunction(){
  // 替换为你的文档ID（从文档URL提取，比如https://docs.google.com/document/d/XXXXXX/edit中的XXXXXX）
  var ad = DocumentApp.openById("你的文档ID");
  // 也可以用完整URL：var ad = DocumentApp.openByUrl("你的文档URL");
  var docBody = ad.getBody () ;
  var paragraphs = docBody.getParagraphs();
  paragraphs[0].setAttributes({FONT_SIZE:40});
}

运行前确保脚本已授权访问该文档。

方法3：检查运行上下文 #

如果是绑定脚本，直接在编辑器点运行时没有关联文档上下文，可先运行onOpen函数，再通过文档内的自定义菜单触发，或设置可安装的「打开文档」触发器，让脚本随文档打开自动运行。

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