使用App Script向Google Sheet添加数据时出现TypeError报错求助

核心问题 #

报错TypeError: Cannot read properties of null (reading 'appendRow')的本质是代码中的sheet变量为null，调用appendRow方法时触发了空值访问错误。导致sheet为null的原因主要有以下三类：

1. 工作表名称不匹配 #

getSheetByName('Sheet1')无法找到对应名称的工作表，直接返回null。请检查目标Google表格：

• 是否存在名称为Sheet1的工作表
• 名称的大小写、空格是否完全一致（比如是否误写为Sheet 1或sheet1）

2. 全局变量初始化的时机/权限问题 #

你将wbook和sheet定义为全局变量，在Google Apps Script中，全局变量会在脚本首次加载时执行初始化。但当脚本作为Web App部署时，全局变量的初始化可能在没有正确权限上下文的情况下运行，导致无法成功获取表格实例，最终sheet为null。

正确的做法是将表格和工作表的获取逻辑移到函数内部，确保每次API调用时都能重新获取有效实例。

3. 表格访问权限不足 #

脚本运行的账号（即你部署Web App时使用的Google账号）没有目标表格的编辑权限，导致SpreadsheetApp.openByUrl无法成功打开表格，后续getSheetByName自然返回null。请确认该账号已被添加为表格的编辑者。

修复后的代码 #

function doPost(e) {
  var action = e.parameter.action;
  if (action == 'addUser') {
    return addUser(e);
  }
}

function addUser(e) {
  // 将表格和工作表的获取移到函数内部，确保每次调用都能正确初始化
  var wbook = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/1qqyKJwc1TTOQyJL0iXbKNhRIvhLHoj10QxpGdosKPv8/');
  var sheet = wbook.getSheetByName('Sheet1');
  
  // 提前检查工作表是否存在，避免空值调用错误
  if (!sheet) {
    return ContentService.createTextOutput("Error: 未找到名为'Sheet1'的工作表");
  }
  
  var user = JSON.parse(e.postData.contents);
  sheet.appendRow([user.name]);
  return ContentService.createTextOutput("Success");
}

额外检查项 #

• 重新部署Web App：修改代码后必须重新部署新版本，否则旧代码仍会生效
• Web App权限设置：如果需要外部API工具调用，部署时请选择“以任何人，甚至匿名用户执行”（注意：匿名访问存在安全风险，建议添加请求验证逻辑）

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