.NET 8独立工作者模式Azure Functions中local.settings.json复制异常导致TimerTrigger配置无法解析的排查求助

大家好，我最近在搭建基于.NET 8的Azure Functions独立工作者模式项目时踩了个坑，折腾了好久才解决，把过程分享出来给遇到同样问题的朋友参考：

问题场景 #

我创建了一个使用TimerTrigger的Azure Functions项目，选的是独立工作者模型，目标框架.NET 8。我在local.settings.json里配置了TimerTrigger的cron表达式，函数里通过%TimerTrigger%引用这个配置，但调试时一直报配置无法解析的错误。

我的配置细节 #

1. 根目录local.settings.json配置 #

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "",
    "FUNCTIONS_WORKER_RUNTIME": "dotnet-isolated",
    "TimerTrigger": "0 59 23 * * * *"
  }
}

2. TimerTrigger函数代码 #

public async Task Run([TimerTrigger("%TimerTrigger%", RunOnStartup = true)] TimerInfo myTimer)
{
    // 函数业务逻辑
}

3. Program.cs入口代码 #

var builder = new HostBuilder();
builder.ConfigureFunctionsWebApplication();
builder.Build().Run();

4. 项目csproj配置 #

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    <AzureFunctionsVersion>v4</AzureFunctionsVersion>
    <OutputType>Exe</OutputType>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>
  <ItemGroup>
    <FrameworkReference Include="Microsoft.AspNetCore.App" />
    <PackageReference Include="Azure.Storage.Blobs" Version="12.24.0" />
    <PackageReference Include="Microsoft.ApplicationInsights.WorkerService" Version="2.23.0" />
    <PackageReference Include="Microsoft.Azure.Functions.Worker" Version="2.0.0" />
    <PackageReference Include="Microsoft.Azure.Functions.Worker.ApplicationInsights" Version="2.0.0" />
    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Http.AspNetCore" Version="2.0.0" />
    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Timer" Version="4.3.1" />
    <PackageReference Include="Microsoft.Azure.Functions.Worker.Sdk" Version="2.0.0" />
    <PackageReference Include="Microsoft.EntityFrameworkCore" Version="9.0.4" />
    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="9.0.4" />
    <PackageReference Include="Microsoft.Extensions.Logging" Version="9.0.4" />
  </ItemGroup>
  <ItemGroup>
    <None Update="host.json">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </None>
    <None Update="local.settings.json">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
      <CopyToPublishDirectory>Never</CopyToPublishDirectory>
    </None>
  </ItemGroup>
  <ItemGroup>
    <Using Include="System.Threading.ExecutionContext" Alias="ExecutionContext" />
  </ItemGroup>
</Project>

报错信息 #

调试启动时，控制台一直输出这个错误：

Microsoft.Azure.WebJobs.Host: Error indexing method 'Functions.Test'. Microsoft.Azure.WebJobs.Host: '%TimerTrigger%' does not resolve to a value.

排查过程中发现的异常 #

我检查输出目录时发现，bin/Debug/net8.0下的local.settings.json完全不是我根目录的版本，内容变成了这样：

{
  "IsEncrypted": true,
  "Values": {
    "FUNCTIONS_WORKER_RUNTIME": "################################"
  }
}

我已经把文件的复制属性改成了「如果较新则复制」甚至「始终复制」，但输出目录里的文件还是丢失了所有自定义配置。而且启动时会弹出选择工作者模型的提示，我选的是独立模式，一度怀疑是不是这里选错了。

最终解决方法 #

折腾了半天后才发现，问题根源竟然在local.settings.json的结构上！我之前为了方便，在文件里加了一些嵌套的JSON配置项，这些多层级结构导致Azure Functions的配置加载逻辑出了问题。

当我把所有配置都改成单层级的键值对（也就是只保留Values下的平级属性，没有任何嵌套对象）后，启动时的提示消失了，输出目录里的local.settings.json终于和根目录保持一致，TimerTrigger也能正常读取到cron表达式了！

内容来源于stack exchange