.NET 7下V4 Azure函数Timer Trigger配置无法生效

我在.NET 7.0上运行Azure Functions V4，Program.cs代码如下：

var host = new HostBuilder()
.ConfigureAppConfiguration((host, builder) =>
{
    builder
        .AddJsonFile("appsettings.json", true, true)
        .AddJsonFile($"appsettings.{host.HostingEnvironment.EnvironmentName}.json", true, true);
}).Build().Run();

我使用%configurationName%约定配置Timer函数每分钟触发，函数代码：

[Function(nameof(FunctionATrigger))]
public async Task Run(
    [TimerTrigger("%Values:TimerTriggerPeriod%", RunOnStartup = false)] TimerInfo timerInfo)
{
}

但持续收到错误：

[2023-03-16T17:44:37.042Z] The 'FunctionATrigger' function is in error: Microsoft.Azure.WebJobs.Host: Error indexing method 'Functions.FunctionATrigger'. Microsoft.Azure.WebJobs.Host: '%Values:TimerTriggerPeriod%' does not resolve to a value.

我已确认host.HostingEnvironment.EnvironmentName为local，对应的appsettings.local.json配置如下：

{
   "Values": {
      "TimerTriggerPeriod": "0 * * * * *"
   }
}

也尝试过用%TimerTriggerPeriod%搭配以下配置，同样失败：

{
   "TimerTriggerPeriod": "0 * * * * *"
}

另外我测试过可以通过依赖注入IConfiguration正常获取该值：

_configuration["Values:TimerTriggerPeriod"]

想问这是不是.NET 7和Azure Functions V4的兼容性问题？

问题原因与解决办法 #

这并非.NET 7与Azure Functions V4的兼容性问题，而是隔离模式下（.NET 7 Azure Functions默认使用隔离模式），触发器属性的配置解析逻辑和进程内模式存在差异：隔离模式下，触发器不会自动读取appsettings.json中的Values节点，且默认优先读取local.settings.json而非自定义的appsettings文件。

解决办法1：使用local.settings.json配置（推荐）

将配置放在local.settings.json的Values节点中：

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
    "FUNCTIONS_WORKER_RUNTIME": "dotnet-isolated",
    "TimerTriggerPeriod": "0 * * * * *"
  }
}

然后修改触发器属性为：

[TimerTrigger("%TimerTriggerPeriod%", RunOnStartup = false)]

解决办法2：手动配置WebJobs服务并调整加载逻辑

如果坚持使用appsettings.json，需要在Program.cs中添加WebJobs相关服务配置，并确保环境变量被加载：

var host = new HostBuilder()
    .ConfigureAppConfiguration((hostContext, config) =>
    {
        config
            .AddJsonFile("appsettings.json", optional: true, reloadOnChange: true)
            .AddJsonFile($"appsettings.{hostContext.HostingEnvironment.EnvironmentName}.json", optional: true, reloadOnChange: true)
            .AddEnvironmentVariables(); // 必须添加，确保配置能被触发器解析
    })
    .ConfigureWebJobs(b =>
    {
        b.AddAzureStorageCoreServices();
        b.AddTimers(); // 注册定时器服务
    })
    .Build();

await host.RunAsync();

此时触发器属性使用%Values:TimerTriggerPeriod%即可正常解析appsettings中的配置值。

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