.NET6中借助Azure Functions的local.settings.json策略摆脱App Service的appsettings.json

核心思路 #

把本地配置文件（比如appsettings.Development.json或直接用local.settings.json）仅作为本地开发调试的专属载体，Azure部署环境彻底摆脱对AppSettings.json的依赖，所有配置统一托管在Azure App Configuration中。

具体实现步骤 #

• 本地开发侧配置：
  保留本地配置文件，只存放本地调试必需的配置项（比如本地数据库连接、调试日志级别等）。本地运行时，通过配置优先级设置，让应用优先读取本地文件，再按需拉取Azure App Configuration的配置（可选），保证本地开发不受云端配置变更影响。
• 部署与云端配置侧：
  1. 将原AppSettings.json中的所有配置项迁移到Azure App Configuration，按环境（生产/测试）用标签区分管理。
  2. 部署时通过.gitignore或部署任务的文件筛选规则，排除AppSettings.json，避免其被上传到Azure环境。
  3. 在应用启动代码中，把Azure App Configuration设为核心配置源。ASP.NET Core示例代码：

     var builder = WebApplication.CreateBuilder(args);
     // 接入Azure App Configuration
     builder.Configuration.AddAzureAppConfiguration(options =>
     {
         options.Connect(builder.Configuration["AzureAppConfigConnStr"])
                .Select(KeyFilter.Any, builder.Environment.EnvironmentName); // 读取对应环境标签的配置
     });
     

  4. 把Azure App Configuration的连接字符串，通过Azure应用服务的应用设置（Application Settings）注入，避免硬编码在本地文件中。
• Release环节适配：
  如果之前Release流程依赖AppSettings.json的配置读取逻辑，直接替换为从Azure App Configuration拉取对应项，或者通过Azure CLI/ARM模板在部署脚本中获取云端配置，替换原文件依赖的步骤。

关键注意点 #

• 配置优先级要明确：Azure App Configuration > 云端应用设置 > 本地配置文件，防止本地配置意外覆盖云端生产配置。
• 敏感配置（密钥、高权限连接字符串）不要放在本地文件，本地开发可配合Azure Key Vault+Azure App Configuration，或直接用本地环境变量替代。

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