.NET 6 C#函数应用读取local.settings.json集合配置失败排查

你遇到的问题核心在于配置绑定系统的工作机制和你的模型类定义不匹配，导致集合始终无法被正确填充。下面一步步拆解问题并给出修复方案：

1. 模型类的核心问题：字段无法被配置绑定 #

.NET的配置绑定系统默认只会处理公共的、带有getter和setter的属性，而你在Products类中使用的是readonly字段products：

public readonly List<Product> products = new List<Product>();

这个字段既不是公共属性，也没有可写的setter，配置绑定系统根本无法向其中写入数据——这是集合为空的主要原因。

2. 配置与模型的结构不匹配 #

你的local.settings.json中，Values下的Products是一个直接的数组（List<Product>），但你试图把它绑定到一个包含列表字段的Products类上，两者的结构对应关系没有对齐，进一步导致绑定失败。

修复方案 #

我们可以通过两种方式来修正，选一种适合你的即可：

方案一：调整模型类，使其适配配置结构 #

修改Products类，将字段改为公共可写属性，并且保持名称和配置节点逻辑一致：

public class Products
{
    // 改为公共属性，添加setter，初始化空列表避免null
    public List<Product> Items { get; set; } = new List<Product>();
}

public class Product
{
    public string ProductId { get; set; }
    public string Title { get; set; }
}

然后修改绑定代码，确保绑定路径正确：

private void BindAndRegisterStronglyTypedConfig(IFunctionsHostBuilder builder)
{
    var products = new Products();
    // 直接将配置中的"Products"数组绑定到Items属性
    builder.GetContext().Configuration.GetSection("Products").Bind(products.Items);
    builder.Services.AddSingleton(products);
}

方案二：直接绑定到List<Product>（更简洁） #

如果不需要额外的Products包装类，可以直接将配置中的数组绑定到List<Product>，代码更轻量化：

private void BindAndRegisterStronglyTypedConfig(IFunctionsHostBuilder builder)
{
    // 直接从配置节获取列表，为空时初始化空集合避免null
    var products = builder.GetContext().Configuration.GetSection("Products").Get<List<Product>>() 
                   ?? new List<Product>();
    builder.Services.AddSingleton(products);
}

这种方式下，你可以完全移除原来的Products类，直接在函数中注入List<Product>即可使用。

额外注意事项 #

• 确保local.settings.json的JSON格式正确，数组的括号、逗号没有语法错误
• 部署到Azure时，这类复杂数组配置需要放到应用设置的JSON类型项中，或者使用Azure App Configuration服务来管理更方便

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