如何在local.settings.json和部署时的appsettings.json中配置Function App的CRON表达式参数

1. 修改Function代码中的TimerTrigger属性 #

把硬编码的CRON表达式替换为配置键占位符，用%配置键名%的格式包裹，示例如下：

[Function("JobsTrigger")]
public void Run([TimerTrigger("%JobsCronSchedule%", RunOnStartup = true)] MyInfo myTimer)
{
    // 函数逻辑代码
}

这里的JobsCronSchedule是自定义的配置键名，可根据实际需求修改。

2. 配置本地开发环境（local.settings.json） #

在项目根目录的local.settings.json文件中，找到Values节点，添加对应的CRON表达式配置：

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
    "FUNCTIONS_WORKER_RUNTIME": "dotnet",
    "JobsCronSchedule": "1,31 * * * * *"
  }
}

注意：local.settings.json仅用于本地开发调试，不会被部署到Azure环境。

3. 配置部署环境（appsettings.json） #

在项目中创建或修改appsettings.json文件，添加相同的配置键值对：

{
  "JobsCronSchedule": "1,31 * * * * *"
}

部署到Azure时，需确保该配置同步到Function App的应用设置中：

• 若用CI/CD工具（如Azure DevOps、GitHub Actions）部署，可通过部署任务将appsettings.json的配置同步到Function App的应用设置；
• 也可直接在Azure门户的Function App「配置」->「应用程序设置」中手动添加JobsCronSchedule键及对应CRON值。

4. 验证配置生效 #

• 本地调试：启动Function App，查看日志确认TimerTrigger是否按配置的CRON规则触发；
• 部署后：通过Azure门户的Function App监控日志，确认定时任务按预期执行。

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