如何解决谷歌表格Apps Script中的TypeError: Cannot read properties of null错误？

错误原因 #

这个TypeError: Cannot read properties of null (reading 'setColumnFilterCriteria')错误，本质是你代码里要调用setColumnFilterCriteria的筛选器对象是null——简单说就是当前工作表里没开筛选，或者代码没正确拿到筛选器。

具体修复步骤 #

1. 先确保工作表有筛选功能 #

打开你的谷歌表格，选中表头所在的行（比如第1行），点击工具栏的「创建筛选」按钮（漏斗图标），确认表头每个单元格都出现筛选箭头。如果手动开了筛选还是报错，就看下一步的代码修改。

2. 修改代码：自动检查并创建筛选器 #

非专业开发者直接抄下面的修复代码，替换你原来的函数即可，注意替换几个关键信息：

• 把"你的工作表名称"改成你实际的工作表标签名（比如"数据统计表"）
• 把"A1:Z1"改成你表头的实际范围（比如表头是第1行A到D列，就写"A1:D1"）
• 把"关键词"改成你要筛选的内容，列号1对应A列，2对应B列，以此类推

修复后的示例代码：

// 自定义菜单触发的筛选函数
function myFilterMenu() {
  // 获取目标工作表
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("你的工作表名称");
  // 获取当前工作表的筛选器
  let filter = sheet.getFilter();
  
  // 如果筛选器不存在，就自动创建一个（基于表头范围）
  if (!filter) {
    const headerRange = sheet.getRange("A1:Z1"); // 替换成你的表头范围
    filter = headerRange.createFilter();
  }
  
  // 设置筛选条件：这里是第1列（A列）包含"关键词"
  const filterCriteria = SpreadsheetApp.newFilterCriteria()
    .whenTextContains("关键词") // 替换成你的筛选规则
    .build();
  filter.setColumnFilterCriteria(1, filterCriteria); // 1是列号，按需修改
}

// 创建自定义菜单的函数
function onOpen() {
  const ui = SpreadsheetApp.getUi();
  ui.createMenu("自定义筛选")
    .addItem("执行筛选", "myFilterMenu") // 这里的函数名要和上面的筛选函数名一致
    .addToUi();
}

3. 让修改后的代码生效 #

• 打开Apps Script编辑器，把原来的代码替换成上面的修复代码，点击保存按钮（软盘图标）。
• 手动运行一次onOpen函数：在编辑器左侧选中onOpen，点击运行按钮（三角图标），授权后刷新谷歌表格，就能看到更新后的自定义菜单。

4. 常见排查小技巧 #

• 工作表名称要完全匹配：比如工作表标签是「销售数据」，代码里就不能写「销售统计」，大小写也要一致。
• 表头范围不能错：如果表头只到D列，就别写A1:Z1，不然会给空列创建筛选，可能出问题。
• 列号别搞混：setColumnFilterCriteria(1, ...)里的1是A列，2是B列，以此类推，别把列号和列名搞混。

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