C#中TimerTrigger CRON定时任务无法触发问题排查求助

核心问题定位 #

你遇到的报错和触发器不生效主要是两个原因：

1. 触发函数缺少[FunctionName]特性，SDK无法识别为作业函数
2. 使用了已废弃的WebJobs SDK 2.x版本的JobHostConfiguration配置写法，和当前运行环境版本不兼容，导致出现乱序的依赖包报错提示

分步修复步骤 #

1. 补全触发器函数特性 #

给你的定时任务方法加上[FunctionName]标记，示例代码如下：

public static class TimerJobFunctions
{
    [FunctionName("StartupJob")]
    public static void StartupJob([TimerTrigger("0 * * * * *", RunOnStartup = true)] TimerInfo timerInfo, ILogger log) 
    {
        log.LogInformation("Timer job fired!");
    }
}

2. 替换过时的JobHost配置 #

如果是基于.NET Core/.NET 5+的项目，删除你原来写的Main方法里的旧配置，改用如下写法：

static async Task Main(string[] args)
{
    var host = Host.CreateDefaultBuilder(args)
        .ConfigureWebJobs(webJobsBuilder =>
        {
            // 注册Timer触发器扩展
            webJobsBuilder.AddTimers();
        })
        .ConfigureLogging(logging =>
        {
            logging.AddConsole();
        })
        .Build();
    // 持续运行作业宿主
    await host.RunAsync();
}

如果是用官方Azure Functions项目模板创建的项目，不需要自己写Main方法，SDK会自动完成宿主配置，直接运行项目即可。

3. 核对依赖包安装 #

卸载不需要的DocumentFormat相关包，安装对应场景的正确依赖：

• In-Process模型Azure Functions：安装Microsoft.NET.Sdk.Functions、Microsoft.Azure.WebJobs.Extensions.Timers
• Isolated Worker模型Azure Functions：安装Microsoft.Azure.Functions.Worker、Microsoft.Azure.Functions.Worker.Extensions.Timer
• 控制台集成WebJobs场景：安装Microsoft.Azure.WebJobs、Microsoft.Azure.WebJobs.Extensions.Timers、Microsoft.Extensions.Hosting

4. 本地运行前置检查 #

运行项目前先启动本地存储模拟器（Azurite或旧版Azure Storage Emulator），TimerTrigger需要依赖存储服务记录调度状态，否则触发器不会正常触发。

5. 2天间隔CRON表达式 #

测试没问题后，把TimerTrigger的CRON表达式替换为0 0 0 */2 * *，即可实现每2天零点执行一次的调度逻辑。

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