如何让Azure Function App重启后不自动补跑错过的历史计划任务

• 每月26日固定运行的Azure Function App因业务原因停用，当月14日重新启用时自动触发执行
• 触发详情返回：UnscheduledInvocationReason: IsPastDue, OriginalSchedule: 2022-05-26T14:05:00.0000000-05:00，触发原因为检测到历史计划运行错过，自动补跑
• 触发详情截图：
• 目标：配置应用禁止自动执行历史错过日期的调度任务

方案1：host.json全局配置（推荐，无代码侵入） #

使用Timer触发器扩展版本≥3.0.15的场景下，直接在函数项目的host.json文件中添加如下配置，即可全局关闭启动时补跑错过调度的逻辑：

{
  "version": "2.0",
  "extensions": {
    "timers": {
      "skipPastDueRunsOnStartup": true
    }
  }
}

配置生效后，函数启动时不会回溯检查历史错过的调度记录，只会从启动时点开始，按照预设的cron规则触发后续任务。
注意：不要将TimerTrigger的RunOnStartup参数设为true，该参数会让函数每次启动时无条件执行一次任务，和历史补跑是独立逻辑。

方案2：代码逻辑拦截补跑请求 #

如果使用的扩展版本不支持上述配置，可以直接在函数入口处添加判断逻辑，识别到是补跑的错过任务时直接终止执行即可。
不同语言的实现逻辑一致，核心是判断触发参数中的IsPastDue字段：

• C# 示例：

[FunctionName("MonthlyScheduledJob")]
public static void Run(
    [TimerTrigger("0 5 14 26 * *")] TimerInfo timerInfo,
    ILogger log)
{
    // 识别到是历史错过的补跑任务，直接返回不执行业务
    if (timerInfo.IsPastDue)
    {
        log.LogInformation("检测到历史补跑请求，跳过执行");
        return;
    }
    // 正常月度任务业务逻辑
    log.LogInformation($"执行月度定时任务，执行时间：{DateTime.Now:yyyy-MM-dd HH:mm:ss}");
}

• Python/JavaScript/Java等其他语言：从Timer触发的请求上下文中读取IsPastDue属性，值为true时直接返回空响应即可。

方案3：停用前清理调度状态记录 #

如果不想修改代码或配置，仅临时停用后重启避免补跑，可以在重新启用函数前，进入函数关联的Azure存储账户，找到azure-webjobs-host blob容器下的locks路径，删除对应定时器触发器的状态blob文件。该文件存储了定时器的历史调度锚点，删除后函数启动时无历史调度记录可回溯，不会触发补跑。

内容的提问来源于stack exchange，提问作者Antony Genil Gregory