部署Azure Function后local.settings.json的Test属性为何缺失？

原因分析 #

Visual Studio部署Azure Function时，默认仅同步两类配置项：

• Azure Functions运行必需的核心配置（如AzureWebJobsStorage、FUNCTIONS_WORKER_RUNTIME）
• 代码中实际被引用的自定义配置项

你的Test配置在代码里没有被读取或使用，因此部署过程会自动跳过该配置，不会同步到云端的应用设置中。另外需要明确：local.settings.json是本地开发专用的配置文件，设计初衷是为本地调试提供环境变量，并非用于完整同步所有配置到生产环境。

解决方法 #

如果需要将Test配置同步到云端，可选择以下任意一种方式：

• 在代码中引用该配置：通过依赖注入读取Test值，即使只是简单读取（无需实际业务使用），部署时VS就会识别并同步该配置。示例代码：

  private readonly IConfiguration _configuration;
  
  public Function1(IConfiguration configuration)
  {
      _configuration = configuration;
      // 读取Test配置，触发同步逻辑
      var testConfig = _configuration["Test"];
  }
  

• 手动添加到云端：登录Azure门户，进入你的Function App，依次点击「配置」→「应用设置」，手动添加Test键和对应的值。
• 自动化部署方式：使用Azure CLI命令或ARM模板定义所有需要的配置项，通过自动化流程部署时可确保所有配置同步到云端。

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