Google Apps Script报错Cannot read properties of undefined求助

1. 验证writeDataToSheet的sheet参数有效性 #

找到所有调用writeDataToSheet的代码，添加日志确认传入的sheet对象是否正常：

// 示例调用代码，添加日志排查
const targetSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('目标工作表名称');
console.log('获取到的Sheet对象:', targetSheet);
writeDataToSheet(targetSheet, yourData);

如果日志显示targetSheet为null，即使确认工作表存在，也可能是以下问题：

• 调用getActiveSpreadsheet()时，当前活动的电子表格并非目标表所在文件
• 工作表名称存在大小写、空格等细微差异（比如"Sheet1"和"sheet1"会被判定为不同名称）

2. 检查writeDataToSheet函数内部逻辑 #

打开函数定义，确认sheet参数处理及data变量的来源：

// 示例函数定义，添加参数校验
function writeDataToSheet(sheet, data) {
  // 先校验sheet是否有效
  if (!sheet) {
    console.error('传入的sheet参数无效');
    return;
  }
  // 校验data是否存在
  if (!data) {
    console.error('data变量未定义');
    return;
  }
  // 后续使用data.length的业务代码
  sheet.getRange(1, 1, data.length, data[0]?.length || 1).setValues(data);
}

如果函数内部的data是从sheet读取的，检查读取逻辑是否会因sheet无效导致data未赋值：

function writeDataToSheet(sheetName) {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(sheetName);
  if (!sheet) {
    console.error('未找到指定工作表');
    return;
  }
  const data = sheet.getDataRange().getValues();
  console.log(data.length); // 报错行
}

3. 对比历史代码定位修改引入的问题 #

由于脚本此前正常运行，重点排查最近修改的代码块：

• 是否调整了writeDataToSheet的参数顺序（比如原本是writeDataToSheet(data, sheet)，修改后参数顺序颠倒，但调用时仍按旧顺序传参）
• 是否修改了data变量的生成逻辑（比如数据读取范围变更，导致返回空值或undefined）
• 是否新增了错误捕获逻辑，掩盖了sheet获取失败的报错，最终导致data未定义

4. 调试辅助技巧 #

• 在data.length代码行前添加日志，确认data的实际值：

  console.log('当前data变量值:', data);
  console.log(data.length);
  

• 查看脚本执行日志（编辑器顶部「查看」→「日志」），获取报错的具体行号和上下文，缩小排查范围

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