.NET 8升级后Azure Functions Timer Trigger配置解析失败排查

问题原因 #

.NET 8的Azure Functions独立工作者模型对配置加载逻辑做了调整：

• .NET 6中，host.json根节点下的自定义配置节（如AppConfigOptions）会被自动纳入应用配置体系，Timer Trigger的占位符能直接解析；
• .NET 8中，Functions Runtime仅默认加载host.json里的Values节点内容到IConfiguration，根节点下的自定义配置节不会自动被识别，导致占位符%AppConfigOptions:MyTimerValue%无法找到对应值。

修复方案 #

方案1：修改host.json结构，将自定义配置移入Values节点 #

调整host.json，把定时器配置放到Values节点下，Runtime会自动加载这部分内容到配置：

{
  "version": "2.0",
  "Values": {
    "AppConfigOptions:MyTimerValue": "0 */5 * * * *",
    "AppConfigOptions:AnotherTimerValue": "0 0 * * * *"
  }
}

无需修改函数代码，原占位符%AppConfigOptions:MyTimerValue%即可正常解析。

方案2：手动加载host.json的自定义配置节到应用配置 #

如果不想调整host.json结构，可在Program.cs中手动将AppConfigOptions节加载到IConfiguration：

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults()
    .ConfigureAppConfiguration((context, config) =>
    {
        var hostJsonPath = Path.Combine(Environment.CurrentDirectory, "host.json");
        if (File.Exists(hostJsonPath))
        {
            // 先加载整个host.json，再单独加载AppConfigOptions节到配置根
            config.AddJsonFile(hostJsonPath, optional: false, reloadOnChange: true)
                  .AddJsonFile(hostJsonPath, optional: false, reloadOnChange: true, options =>
                  {
                      options.Path = "AppConfigOptions";
                  });
        }
    })
    .Build();

host.Run();

该方式会把AppConfigOptions下的所有配置项合并到应用配置中，占位符可正常解析。

方案3：将定时器配置移至local.settings.json #

将定时器配置放到local.settings.json的Values节点，这是Azure Functions本地开发的标准配置方式：

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
    "FUNCTIONS_WORKER_RUNTIME": "dotnet-isolated",
    "AppConfigOptions:MyTimerValue": "0 */5 * * * *",
    "AppConfigOptions:AnotherTimerValue": "0 0 * * * *"
  }
}

同样无需修改函数代码，占位符可直接解析。

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