Google Apps Script定时触发器失效问题排查求助

你创建了每天10:14触发getScoreEntries的定时触发器，手动运行函数正常，但触发器从未执行，管理界面可见触发器。以下是具体排查步骤：

1. 查看触发器执行日志 #

打开脚本编辑器，点击左侧菜单「执行」，查看所有执行记录（包括失败项）。定时触发器执行失败会在这里显示具体错误信息，这是最直接的排查入口。

2. 排查上下文与权限差异 #

定时触发器运行在无用户交互的后台上下文，和手动运行存在关键差异：

• 若脚本是独立脚本（未绑定到表格），SpreadsheetApp.getActive()会返回null，需改用openById/openByUrl明确指定表格；绑定脚本则无此问题，但需确保触发器创建者拥有目标表格的编辑权限。
• getScoreEntries中调用SpreadsheetApp.openById(RESULT_SSID)，需确认RESULT_SSID是正确的表格ID，且创建触发器的用户有权访问该表格。

3. 检查未定义的变量/函数 #

你提供的代码中存在多个未定义的标识符：

• entityBeingToggled、DATA_ENTRY_SHEETNAME、AUDIT_ID_HEADERNAME
• 自定义函数validScoreHeader、aggregateAllRows
• RESULT_SSID、RESULT_SHEET_NAME

若这些标识符未在脚本的其他文件中定义，定时触发器运行时会直接抛出ReferenceError导致执行失败（手动运行可能因上下文缓存未暴露问题）。请确保所有变量和自定义函数都已正确定义。

4. 验证触发器时间设置 #

nearMinute(14)会让触发器在指定分钟前后15分钟内执行（即10:00-10:30之间），并非精确到10:14。若需要精确时间，可改用以下代码创建触发器：

const triggerTime = new Date();
triggerTime.setHours(10, 14, 0, 0);
ScriptApp.newTrigger(triggerFunctionName)
  .timeBased()
  .at(triggerTime)
  .create();

注：此方法仅创建一次触发，若需每日重复，需在函数执行完后重新创建触发器，或保留原everyDays(1).nearMinute(14)的写法（接受时间范围）。

5. 测试极简触发器 #

为排除代码逻辑问题，先创建测试函数验证触发器基础功能：

function testTrigger() {
  const testSheet = SpreadsheetApp.getActive().getSheetByName("测试表");
  if (testSheet) {
    testSheet.appendRow([new Date(), "触发器执行成功"]);
  }
}

创建相同时间规则的触发器，若测试函数能正常执行，说明问题出在getScoreEntries的代码逻辑中；若仍无法执行，需检查触发器的启用状态、执行用户权限。

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