Azure App Service中.NET 6 Web API配置与环境变量同步问题

我有一个部署在Azure App Service（Windows）上的.NET 6 Web API，使用标准IConfiguration从appsettings.json读取配置。通过Visual Studio部署后，代码已更新，且Kudu确认App Service内的appsettings.json已更新，但这些更改并未同步到「设置」→「环境变量」→「应用设置」选项卡中。不清楚之前开发者如何为appsettings.json的每个值创建对应环境变量，有以下疑问及解答：

疑问1：这些环境变量必须手动添加/更新吗？ #

不是必须，但Azure默认不会自动把appsettings.json的内容同步为环境变量。如果要通过应用设置（环境变量）管理配置，手动添加是最直接的方式，但也有自动化方案可以替代手动操作。

疑问2：是否有工具可自动同步appsettings.json新条目并创建对应环境变量？ #

有几种实用的自动化方式：

• Azure CLI脚本：编写PowerShell或Python脚本，解析appsettings.json的键值对，批量调用az webapp config appsettings set命令完成同步。例如，PowerShell可以用Get-Content读取json，遍历后生成CLI命令执行。
• Azure DevOps Pipeline：在发布阶段添加「Azure App Service Settings」任务，配置从appsettings.json导入配置；或者用自定义脚本任务实现批量同步。
• 自定义工具：也可以借助一些Azure配置管理的第三方工具，但脚本和Pipeline是最常用且易实现的方案。

疑问3：我在Visual Studio中右键点击appsettings.json选择「发布appsettings.json」无效，是否使用方式有误？ #

这个功能的作用只是确保appsettings.json被包含在发布包中，最终部署到App Service的文件系统里，并不会把文件内容转换为环境变量。你的操作没有问题，只是这个功能的用途和你预期的不一致。

疑问4：环境变量页面的「拉取引用值」按钮是否用于从Key Vault拉取更新后的值？ #

是的。当你的应用设置中配置了Key Vault密钥引用（格式为@Microsoft.KeyVault(SecretUri=密钥URI)），点击这个按钮会触发Azure从Key Vault拉取最新的密钥值，自动更新到应用设置中，无需手动输入新值。

疑问5：该项目用环境变量重复所有appsettings.json设置是否为常见标准做法？我通常部署对应环境的appsettings.<env name>.json并设置ASPNETCORE_ENVIRONMENT变量。 #

这两种都是.NET应用在Azure上的常见配置管理方式，各有适用场景：

• 部署环境特定json文件：适合非敏感、无需频繁变更的配置，部署时直接替换文件，管理直观，无需额外操作。
• 应用设置（环境变量）覆盖：适合敏感配置（如连接字符串、密钥），因为Azure应用设置会加密存储，且可在门户直接修改，无需重新部署代码，灵活性更高。

把所有配置都转成环境变量并非强制标准做法，通常建议混合使用：敏感配置放在应用设置，普通配置留在json文件中。之前的开发者可能是为了统一在Azure门户管理所有配置才采用全环境变量的方式。

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