Docker Compose环境变量配置appsettings.json数组段不生效如何解决？

核心原因 #

你当前的环境变量不符合.NET配置系统的绑定规则，两个关键错误点：

1. 嵌套属性的分隔符错误：所有层级嵌套（包括对象嵌套、数组索引）都需要用双下划线__分隔，不能用单下划线
2. 属性名不匹配：环境变量的字段名必须和appsettings.json里的配置字段完全对应，你当前用的ServiceId、Username、Password和appsettings里的Service、NugetKey、NugetValue不一致，导致绑定失败。

正确配置方案 #

1. Docker Compose环境变量修正写法 #

完全匹配你的appsettings结构的环境变量配置如下：

environment:
  # 第1个插件配置（索引0）
  - PluginManager__Plugins__0__Service=TestService_1
  - PluginManager__Plugins__0__NugetRepository__Url=https://nugetUrl
  - PluginManager__Plugins__0__NugetRepository__NugetKey=username
  - PluginManager__Plugins__0__NugetRepository__NugetValue=Password
  - PluginManager__Plugins__0__Package__Name=TestPackage
  - PluginManager__Plugins__0__Package__Version=1.0.0
  # 第2个插件配置（索引1）
  - PluginManager__Plugins__1__Service=TestService_2
  - PluginManager__Plugins__1__NugetRepository__Url=https://nugetUrl
  - PluginManager__Plugins__1__NugetRepository__NugetKey=username
  - PluginManager__Plugins__1__NugetRepository__NugetValue=Password
  - PluginManager__Plugins__1__Package__Name=TestPackage
  - PluginManager__Plugins__1__Package__Version=1.0.3

2. 动态扩展数组的方法 #

不需要修改任何代码或appsettings结构，新增插件只需要按索引顺序递加前缀即可，比如加第三个插件就使用PluginManager__Plugins__2__作为前缀，按照上面的格式补充对应字段即可，.NET配置系统会自动识别连续索引的配置并绑定为数组。

3. 额外检查项 #

如果是控制台应用，需要确认配置构建器中已添加环境变量源：

var config = new ConfigurationBuilder()
    .AddJsonFile("appsettings.json")
    .AddEnvironmentVariables() // 必须添加这行才能读取环境变量配置
    .Build();

Web应用默认已内置该配置，无需额外修改。

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