如何在Linux应用服务中正确格式化嵌套JSON结构的应用设置

一、含句点的应用设置名称自动替换为下划线的解决方案 #

Linux应用服务基于容器运行，环境变量不允许包含句点（.），因此平台会自动将应用设置名称中的句点替换为下划线（_）。针对这个问题，你可以通过以下两种方式处理：

• 适配下划线格式
  修改应用的配置读取逻辑，将原本期望的带句点键名，映射为下划线格式。例如原设置名MyApp.Setting，在代码中读取MyApp_Setting对应的环境变量值。
• 使用双下划线替代句点
  若你的应用框架支持（如.NET Core），配置时用双下划线（__）代替句点。平台会自动将双下划线转换为句点传递给应用，比如设置MyApp__Setting，应用中可直接读取MyApp.Setting。

二、嵌套JSON键（如ApplicationInsights:InstrumentationKey）的格式化 #

对于嵌套的JSON配置键，Linux应用服务支持两种层级表示方式，适配不同应用框架：

• 冒号分隔层级（推荐）
  直接在应用设置名称中使用冒号（:）分隔嵌套层级，比如ApplicationInsights:InstrumentationKey。平台会自动将其解析为嵌套JSON结构传递给应用，应用可直接按原嵌套键名读取。
• 双下划线分隔层级
  若框架对冒号支持不佳，改用双下划线（__）替代，比如ApplicationInsights__InstrumentationKey，应用框架会自动转换为ApplicationInsights.InstrumentationKey的嵌套配置项。

示例（.NET Core应用） #

配置以下应用设置：

ApplicationInsights:InstrumentationKey = xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
MyApp__ApiUrl = https://api.example.com

应用中可通过以下方式读取：

var instrumentationKey = Configuration["ApplicationInsights:InstrumentationKey"];
var apiUrl = Configuration["MyApp.ApiUrl"];

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