调用IConfigurationBuilder.Build时Azure返回HTTP 500错误问题求助

一、核心触发原因 #

你当前的场景属于典型的Azure运行时配置缺失问题：

• 本地运行时，AppConfig连接字符串存储在本地机密管理器（secrets.json）、appsettings.json或者本地环境变量中，可被配置源正常读取。
• 发布到Azure App Service后，平台不会同步本地的机密配置，且你未在Azure门户侧为App Service配置对应的连接字符串，导致settings.GetConnectionString("AppConfig")返回null，后续初始化Azure App Configuration客户端时抛出未处理异常，触发500错误。硬编码连接字符串绕过了配置读取步骤，所以运行正常。

二、获取详细错误的方法 #

• 临时开启开发人员异常页：在Program.cs的中间件配置最顶部临时添加生产环境异常页配置，代码如下：

if (app.Environment.IsProduction())
{
    app.UseDeveloperExceptionPage();
}

发布后直接访问站点即可看到完整异常堆栈，排查完成后务必删除该配置，避免生产环境泄露敏感信息。

• 查看Kudu控制台日志：进入对应App Service的Azure门户，左侧菜单选择「高级工具」>「转到」打开Kudu控制台，依次进入「Debug console」>「CMD」> LogFiles目录，查看eventlog.xml或者stdout开头的日志文件，可捕获到应用启动阶段的所有异常，这类启动异常通常不会写入普通应用日志。
• 开启标准输出日志：在App Service门户的「配置」>「通用设置」中，开启「stdout日志输出」，重启应用后所有启动阶段的控制台日志都会写入日志文件，可完整追溯启动错误。

三、直接修复方案 #

在对应App Service的Azure门户左侧菜单选择「配置」>「连接字符串」，添加如下配置项：

• 名称：AppConfig
• 值：你的Azure App Configuration服务的完整连接字符串
• 类型：选择Custom
  保存配置后App Service会自动重启，即可正常读取连接字符串，无需硬编码。

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