Google Apps Script勾选复选框触发onEdit函数失效问题排查

核心触发限制（移动端失效的根本原因） #

你现在用的onEdit是Google Apps Script的简单触发器，天生不适合当前场景，问题来自这几个硬性规则：

• 简单触发器运行时没有用户授权，根本调用不了你代码里用到的DriveApp、MailApp、UrlFetchApp这类需要权限的服务。你手动在控制台跑的时候，用的是自己账号的授权权限，所以能正常运行；触发器触发时是低权限上下文，碰到需要授权的代码会直接静默失败，不会弹出任何报错提示。
• 简单触发器上下文里禁止调用SpreadsheetApp.getUi()相关的交互接口，你写的确认弹窗逻辑在onEdit里本来就无法运行，更何况手机/平板端的Google表格完全不支持Ui类弹窗，这部分逻辑在移动端100%失效。
• 移动端表格本身对简单onEdit触发器的兼容存在已知问题，复选框点击的操作在很多移动端版本里不会被识别为标准编辑事件，根本不会触发onEdit函数。

现有代码的硬错误 #

就算解决了触发器权限问题，你现在的代码本身也跑不通，具体错误点：

1. 变量作用域混乱
   • 你把sheet、recipient、response、sheet_as_pdf_blob_document这些变量写在全局位置，函数内部调用时经常出现未定义问题：比如start()函数里直接用sheet变量，但start()内部从来没定义过这个变量，一运行就报引用错误。
   • copyDocument()函数里一会用内部定义的contract_sheet，一会用全局的sheet，变量名混着用，必然报错。
   • createFolder()里判断文件夹是否存在的逻辑写错了，if(doesntExists = true)是赋值操作，不是比较判断，会导致不管文件夹存不存在都走新建逻辑。
2. 执行逻辑顺序错误
   • 你把导出PDF的UrlFetchApp.fetch逻辑写在了全局位置，脚本一加载就会执行，根本等不到你勾选复选框，不仅导出的PDF内容是旧的，还会提前消耗请求配额。
   • 现在的onEdit逻辑只判断了单元格是不是勾选状态，没判断是不是A1单元格，也没判断单元格是不是复选框，在其他单元格做编辑操作很容易误触发，碰到非复选框单元格调用isChecked()还会直接报错。

适配移动端的修复方法 #

• 放弃简单onEdit触发器，改用可安装编辑触发器，创建触发器的时候给它开通Drive、邮件、外部请求的对应权限。注意触发器绑定的函数不要叫onEdit，改成比如checkboxTrigger，避免和简单触发器重名导致重复触发。
• 把所有SpreadsheetApp.getUi()的弹窗逻辑全部删掉，移动端根本不支持这类交互，要做二次确认就在表格里加第二个复选框，不要用弹窗。
• 把所有写在全局位置的业务逻辑（取收件人、导出PDF、取工作表对象）全部移到对应的函数内部，不要放在全局作用域，避免提前执行和变量找不到的问题。
• 触发逻辑不要用getActiveRange()取单元格，改用事件对象传入的e.range，避免活动单元格取错的问题，修复后的触发逻辑参考：

// 这个函数需要绑定可安装编辑触发器
function checkboxTrigger(e) {
  if (!e) throw new Error("请通过触发器运行此函数");
  const range = e.range;
  const sheet = range.getSheet();
  // 只响应A1单元格的勾选动作
  if (range.getA1Notation() !== "A1" || range.isChecked() !== true) return;
  // 先取消勾选，防止重复触发
  range.uncheck();
  // 执行后续保存、发邮件的业务逻辑，所有用到的变量都在业务函数内部定义，不要依赖全局变量
  runSaveAndSend(sheet);
}

• 修复所有变量引用错误：比如start()函数里要先拿到对应的sheet对象再读单元格值，createFolder()里的判断条件改成if(doesntExists === true)，所有函数内部用到的对象都在函数内部声明或者通过参数传入，不要混用全局变量。

注意：移动端Google表格对脚本的支持本身比桌面端差，所有触发器绑定的逻辑里不能加任何需要桌面端UI交互的代码，否则必然运行失败。

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