Google Apps Script使用nearMinute(16)创建每小时触发器运行异常

问题原因 #

你遇到的情况是Google Apps Script时钟触发器的正常调度逻辑导致的，核心有4个常见诱因：

• nearMinute()的调度逻辑本身允许动态调整：该方法的设计目标是分散服务器负载，低负载场景下确实会遵循「指定分钟±15分钟」的运行窗口，当对应窗口的服务器压力过高时，调度系统会自动把触发器分配到其他低负载的分钟位，属于正常的资源调度行为。
• 旧触发器的时间槽被复用：如果你此前给myFunction创建过其他每小时运行的触发器，Google的调度系统会优先复用已有的时间槽给同目标函数的新触发器，不会因为你新设置了nearMinute(16)就重新分配时间。
• 存在冗余触发器：你多次执行createTrigger()函数生成了多个重复触发器，你观测到的52分运行的触发器不是本次设置生成的，是之前遗留的旧触发器。
• 项目触发器配额不足：如果你的账号当前触发器运行配额接近上限，低优先级的时间触发器会被分配到低负载的时间窗口运行，减少配额挤占。

解决方法 #

• 先打开Apps Script编辑器左侧的「触发器」面板，删除所有目标函数为myFunction的旧触发器，再重新执行一次创建函数验证。
• 检查脚本时区设置：打开「项目设置」确认脚本时区和你本地时区一致，避免时间换算出现偏差。
• 如果需要更稳定的分钟位调度，不要使用nearMinute()，改用atMinute()方法，示例代码如下：

function createTrigger() {
  ScriptApp.newTrigger('myFunction')
    .timeBased()
    .atMinute(16)
    .everyHours(1)
    .create();
}

atMinute()仅会有±1分钟的调度误差，不会出现超过10分钟的大幅偏移。

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