.NET 6 Azure Function local.settings.json绑定IOptions取值异常问题

• Azure Functions 运行时对local.settings.json有特殊的默认加载规则：仅会自动将文件中Values、ConnectionStrings两个节点下的键值对注册到IConfiguration配置系统，和这两个节点平级的自定义根节点（比如你当前写的ErpConfiguration）默认不会被加载，因此调用Bind方法时找不到对应配置节点，映射出的选项类属性全是null或默认值。
• 部分旧资料提到的“根节点存自定义配置”的写法，本质是手动追加了指向local.settings.json的JSON配置源才实现读取，这种方案需要硬编码配置文件名，且部署到云端时local.settings.json默认不会随项目发布，容易产生环境兼容问题。

全程不需要手动指定本地配置文件路径，完全兼容后续接入Azure App Configuration的部署场景，按以下步骤调整即可：

1. 调整local.settings.json配置结构 #

将原平级放在根节点的ErpConfiguration配置，转换为以:为层级分隔符的键值对，统一放到Values节点下。.NET配置系统原生识别:作为层级分隔符，该规则对本地配置、Azure应用设置、Azure App Configuration等所有配置源通用。
调整后的配置示例：

{
  "IsEncrypted": false,
  "Values": {
    "FUNCTIONS_WORKER_RUNTIME": "dotnet",
    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
    "AzureWebJobsSecretStorageType": "files",
    "SQLAZURECONNSTR_SqlConnection": "yyyy",
    "SqlConnection": "zzzzz",
    "QueueStorage": "xxxxxx",
    "ErpConfiguration:BaseUri": "https://localhost:7209/",
    "ErpConfiguration:CompanyDetail:DaysInPastToCollect": 1,
    "ErpConfiguration:CompanyDetail:GetCount:ItemsPerPage": 50,
    "ErpConfiguration:CompanyDetail:GetCount:Endpoint": "xxxx/count",
    "ErpConfiguration:CompanyDetail:GetList:Format": "json",
    "ErpConfiguration:CompanyDetail:GetList:StorageQueueName": "local-emulator",
    "ErpConfiguration:CompanyDetail:GetList:Endpoint": "xxxx",
    "ErpConfiguration:CompanyDetail:GetList:UrlFilters:UseLastUpdatedDateFilter": true,
    "ErpConfiguration:CompanyDetail:GetList:UrlFilters:UseFormatFilter": true,
    "ErpConfiguration:CompanyDetail:GetList:UrlFilters:UsePaginationFilters": true,
    "ErpConfiguration:CompanyDetail:GetList:UrlFilters:SelectedColumns": "CompCode, Lastupdateddate"
  }
}

2. 校验配置类定义 #

检查ErpConfiguration及所有嵌套子配置类（对应CompanyDetail、GetCount、GetList、UrlFilters节点），确保需要绑定的属性满足以下要求，否则会出现绑定失败：

• 属性为public访问级别
• 提供公开的set或init访问器
• 所属类提供无参构造函数
  参考类定义示例：

public class ErpConfiguration
{
    public string BaseUri { get; set; }
    public CompanyDetail CompanyDetail { get; set; } = new();
}

public class CompanyDetail
{
    public int DaysInPastToCollect { get; set; }
    public GetCountConfig GetCount { get; set; } = new();
    public GetListConfig GetList { get; set; } = new();
}

public class GetCountConfig
{
    public int ItemsPerPage { get; set; }
    public string Endpoint { get; set; }
}

public class GetListConfig
{
    public string Format { get; set; }
    public string StorageQueueName { get; set; }
    public string Endpoint { get; set; }
    public UrlFiltersConfig UrlFilters { get; set; } = new();
}

public class UrlFiltersConfig
{
    public bool UseLastUpdatedDateFilter { get; set; }
    public bool UseFormatFilter { get; set; }
    public bool UsePaginationFilters { get; set; }
    public string SelectedColumns { get; set; }
}

3. 原有业务代码无需修改 #

你之前写的AddConfig配置绑定扩展、服务中注入IOptions<ErpConfiguration>的逻辑完全可以保留，不需要做任何调整，重启函数应用即可正常读取所有配置值。

• 本地开发：完全基于Azure Functions默认配置加载规则实现，没有额外追加自定义配置源，不存在硬编码路径问题。
• 生产部署：后续不管是用函数应用自带的应用设置/连接字符串，还是接入Azure App Configuration、Azure Key Vault作为配置源，只要按照根节点:子节点:属性名的格式配置键名，原有绑定逻辑可以直接复用，不需要做代码修改。

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