Google Apps Script 执行setColumnFilterCriteria时访问文档报错如何解决？

问题修复方案 #

你的代码存在3处不符合Google Apps Script语法规范和最佳实践的问题，共同导致了背景色过滤规则设置时报错，修复方案如下：

修复后完整代码 #

function deletecolor() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet1 = ss.getSheetByName("Master");
  // 修正1：移除多余的数组括号，传入合法的A1范围字符串
  var range = sheet1.getRange('A:L');
  
  // 修正2：创建过滤器前先清理已有过滤器，避免实例冲突
  var existingFilter = sheet1.getFilter();
  if (existingFilter) {
    existingFilter.remove();
  }
  var filter = range.createFilter();
  
  // 修正3：补全build()调用，生成合法的过滤规则对象
  var Filter_Depreciated = SpreadsheetApp.newFilterCriteria()
    .whenTextDoesNotContain("DEPRECATED")
    .build();
  var Filter_Background = SpreadsheetApp.newFilterCriteria()
    .setVisibleBackgroundColor(SpreadsheetApp.newColor().setRgbColor("#ffffff").build())
    .build();
  
  filter.setColumnFilterCriteria(1, Filter_Depreciated);
  filter.setColumnFilterCriteria(4, Filter_Background);
}

改动说明 #

• 修正getRange参数错误：原代码传入了['A:L']数组，该方法实际接收A1格式字符串即可，多余的数组括号会导致范围解析异常，属于隐性风险。
• 新增已有过滤器清理逻辑：如果当前工作表已经存在过滤器，直接调用createFilter会生成冲突的过滤器实例，后续设置列规则时就会触发服务访问错误。
• 补全FilterCriteria的build()调用：通过newFilterCriteria()生成的是规则构造器对象，所有配置完成后必须调用.build()方法才能生成合法的过滤规则对象，传入未build的构造器对象给setColumnFilterCriteria，就会触发不可预期的服务报错。之前文本过滤规则未报错属于偶发兼容情况，不符合官方语法要求。

补充排查点 #

如果修改后仍报错，可排查以下场景：

• D列的背景色如果是条件格式生成的，setVisibleBackgroundColor无法识别，会触发报错，可替换为手动读取D列背景色筛选行的逻辑规避。
• 确认你的账号对该表格有编辑权限，没有被限制设置过滤器规则。

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