Azure Function依赖注入IConfiguration读取local.settings.json配置方法

dotnet-isolated 模式下，运行时会默认自动将local.settings.json的配置加载到IConfiguration依赖注入容器，不需要手动添加配置源，但local.settings.json的Values节点有严格格式要求，不符合规范的配置项会被直接忽略，按以下步骤调整即可正常读取配置：

• 第一步：修正local.settings.json的格式错误与结构问题
  你当前的配置文件存在3个会导致读取失败的问题：
  1. Values节点仅支持字符串类型的扁平键值对，你写的嵌套Email对象、数字类型的SendDeveloperMails值都会被运行时跳过
  2. JSON结构末尾存在多余逗号，会导致文件解析失败
     修正后的配置文件参考如下：

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
    "FUNCTIONS_WORKER_RUNTIME": "dotnet-isolated",
    "EmailProcessConnection": "",
    "SendDeveloperMails": "false",
    "Email:Email": "",
    "Email:Password": ""
  },
  "ConnectionStrings": {
    "HumanRisksDbContext": ""
  }
}

配置层级统一用冒号:分隔，所有Values下的值都必须是字符串类型，嵌套结构要展开为扁平键值对。

• 第二步：确认Program.cs的服务注册逻辑
  框架默认已经完成IConfiguration的注册，你只需要正常注册自己的业务服务、DbContext、日志组件即可，不需要手动传入配置实例，参考代码：

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults()
    .ConfigureServices(services =>
    {
        // 注册DbContext，可直接通过IConfiguration读取连接字符串
        services.AddDbContext<HumanRisksDbContext>(options =>
        {
            var config = services.BuildServiceProvider().GetRequiredService<IConfiguration>();
            options.UseSqlServer(config.GetConnectionString("HumanRisksDbContext"));
        });
        // 注册自定义日志组件
        services.AddScoped<ILogHandler, LogHandler>();
        // 注册业务服务，IConfiguration会通过构造函数自动注入
        services.AddScoped<ControlRisksService>();
    })
    .Build();

host.Run();

• 第三步：按预期方式读取配置
  配置格式修正后，你写的读取逻辑可以正常运行：

// 读取布尔类型配置，支持"true"/"false"、"1"/"0"这类可转换为bool的字符串值
bool sendDevMails = _config.GetValue<bool>("SendDeveloperMails");
// 读取嵌套配置
string emailAddr = _config.GetValue<string>("Email:Email");

注意事项：

1. 本地调试时要把local.settings.json的文件属性设置为「如果较新则复制」到输出目录，否则运行时找不到配置文件
2. 部署到Azure时不需要上传local.settings.json，直接在函数应用的「应用程序设置」「连接字符串」中配置对应项即可，应用设置里的层级分隔符用双下划线__（比如Email__Email），运行时会自动转换为冒号分隔的配置键

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