Google Apps Script Web App报错：无法将undefined/null转为对象

核心错误原因 #

报错Uncaught TypeError: Cannot convert undefined or null to object触发于Object.values(res.items)，说明客户端收到的res.items是null或undefined。结合你描述的服务端日志正常但客户端接收异常的情况，问题大概率出在数据传输序列化、客户端不必要的方法调用或服务端空数据处理缺失上。

分步解决方案 #

1. 先确认客户端实际接收的数据 #

在客户端的successHandler中添加日志，明确收到的响应结构：

function sheetData(){
  google.script.run.withSuccessHandler(function(res) {
    // 打印完整响应，确认数据结构
    console.log('完整响应对象:', res);
    console.log('res.items的值:', res.items);
    console.log('res.items的类型:', typeof res.items);

    // 安全处理数据
    if (res?.items && Array.isArray(res.items)) {
      menuItems = res.items; // 直接赋值数组，无需Object.values
      orders = res.orders || [];
      order.menu = menuItems;
      order.previousOrders = orders;
      Ui.menu(order);
      Ui.orderNumber(order);
    } else {
      console.error('res.items不是有效数组:', res.items);
    }
  }).getData();
}

2. 移除不必要的Object.values()调用 #

res.items本身就是从电子表格获取的二维数组，Object.values()是用来提取对象的属性值的方法，对数组使用完全多余，反而会在res.items为空时直接触发错误。直接用menuItems = res.items即可。

3. 服务端添加空数据校验 #

避免工作表无数据或不存在时返回异常，修改服务端代码：

function getData() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  let items = [];
  const itemsWS = ss.getSheetByName('Items');
  
  // 确保工作表存在且有数据行（除表头外）
  if (itemsWS && itemsWS.getLastRow() > 1) {
    items = itemsWS.getRange(2, 1, itemsWS.getLastRow()-1, itemsWS.getLastColumn()).getValues();
  }

  let orders = [];
  const ordersWS = ss.getSheetByName("Orders");
  if (ordersWS && ordersWS.getLastRow() > 1) {
    orders = ordersWS.getRange(2, 1, ordersWS.getLastRow()-1, ordersWS.getLastColumn()).getValues();
  }

  return { items, orders };
}

这样即使工作表为空或不存在，也会返回空数组，不会导致客户端收到null。

4. 检查Web App部署设置 #

• 确保部署时执行应用为：我自己
• 谁有权访问应用选择符合需求的选项（比如任何人，甚至匿名）
• 每次修改代码后务必重新部署，避免客户端加载旧缓存代码

5. 绕过内置序列化异常（可选） #

如果上述步骤仍有问题，尝试手动序列化/反序列化数据：
服务端：

function getData() {
  // （保留上述数据获取逻辑）
  return JSON.stringify({ items, orders });
}

客户端：

google.script.run.withSuccessHandler(function(jsonStr) {
  const res = JSON.parse(jsonStr);
  // 后续数据处理逻辑
}).getData();

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