将Clover数据导入Google Sheet时遇TypeError错误求解决

错误原因 #

你遇到的TypeError: Cannot read properties of undefined (reading 'elements')，本质是代码尝试访问一个undefined对象的elements属性，可能有两个触发点：

• API返回的数据data里没有elements字段（比如请求失败、权限错误返回了非预期的JSON结构）
• 某个订单order的lineItems字段不存在，或者lineItems本身没有elements字段

解决步骤 #

1. 增加API响应的错误检查 #

先确认API请求是否成功，避免解析无效JSON导致后续报错：

• 检查HTTP响应状态码，只有成功（200状态）才继续处理
• 用try-catch包裹JSON解析和后续数据处理，捕获异常后不会直接中断程序

2. 对所有可能的undefined属性做前置检查 #

在访问data.elements、order.lineItems.elements之前，先判断这些属性是否存在，避免直接访问触发报错

修改后的完整代码 #

function getCloverSales(startDate, endDate) {
  // 覆盖传入参数（如果不需要可以删掉这两行，用外部传入的startDate/endDate）
  var startDate = "1675530917000"; // 毫秒级时间戳
  var endDate = "1676177999000";   
  var API_KEY = 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx';
  var MERCHANT_ID = 'xxxxxxxxxxxxx';
  var url = 'https://api.clover.com/v3/merchants/' + MERCHANT_ID + '/orders?filter=createdTime%3E' + startDate + '&filter=createdTime%3C' + endDate + '&expand=lineItems&limit=1000&orderBy=createdTime';
  
  try {
    var response = UrlFetchApp.fetch(url, {
      headers: {
        Authorization: 'Bearer ' + API_KEY
      }
    });

    // 检查HTTP响应状态码，确保请求成功
    if (response.getResponseCode() !== 200) {
      Logger.log('API请求失败，状态码：' + response.getResponseCode());
      Logger.log('响应内容：' + response.getContentText());
      return;
    }

    var data = JSON.parse(response.getContentText());
    Logger.log(startDate);
    Logger.log(endDate);
    Logger.log(data);

    var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Sales Custom');
    if (!sheet) {
      Logger.log('未找到名为"Sales Custom"的工作表');
      return;
    }
    sheet.clearContents();
    sheet.appendRow(['Date', 'Item Code', 'Item Name', 'Price', 'Order Ref']);

    // 先检查data.elements是否存在且是数组
    if (!data.elements || !Array.isArray(data.elements)) {
      Logger.log('没有获取到订单数据');
      return;
    }

    for (var i = 0; i < data.elements.length; i++) {
      Logger.log('处理第' + (i+1) + '个订单');
      var order = data.elements[i];
      
      // 检查order.lineItems是否存在且有elements数组
      if (!order.lineItems || !order.lineItems.elements || !Array.isArray(order.lineItems.elements)) {
        Logger.log('订单' + (i+1) + '没有商品明细，跳过');
        continue;
      }

      var lineItems = order.lineItems.elements;
      for (var j = 0; j < lineItems.length; j++) {
        Logger.log('处理第' + (j+1) + '个商品');
        var lineItem = lineItems[j];
        // 可选：检查lineItem的必要字段是否存在，避免后续赋值报错
        if (!lineItem.name || !lineItem.itemCode || !lineItem.createdTime || !lineItem.price) {
          Logger.log('商品明细字段不全，跳过');
          continue;
        }

        var itemName = lineItem.name;
        var itemCode = lineItem.itemCode;
        var itemTime = lineItem.createdTime;
        var date = new Date(itemTime);
        var formattedDate = Utilities.formatDate(date, 'GMT-7:00', 'MM-dd-yyyy HH:mm:ss');
        var price = lineItem.price / 100; // 分转元
        var orderRef = lineItem.orderRef || '无订单编号'; // 处理orderRef可能不存在的情况

        sheet.appendRow([formattedDate, itemCode, itemName, price, orderRef]);
      }
    }
  } catch (error) {
    Logger.log('程序执行出错：' + error.message);
    Logger.log('错误堆栈：' + error.stack);
  }
}

关键修改说明 #

• 用try-catch包裹整个核心逻辑，捕获所有异常并记录日志，不会直接中断程序
• 增加HTTP状态码检查，提前发现API请求失败的情况
• 对data.elements、order.lineItems.elements做存在性和类型检查，避免访问undefined属性
• 对商品明细的必要字段做检查，防止因字段缺失导致后续报错
• 处理orderRef可能不存在的情况，给默认值避免写入空值

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