部署至Azure App Service时Serilog读取appsettings.json启动失败排查

问题核心原因 #

你的配置存在两个关键问题：

1. Application Insights Sink缺少InstrumentationKey配置：硬编码方式中明确传入了InstrumentationKey，但appsettings配置里的Application Insights接收器未指定该参数，导致部署到Azure时无法初始化日志接收器，触发启动错误。
2. 环境配置文件未适配生产环境：你仅在appsettings.Development.json中配置了Serilog，但Azure App Service默认运行在Production环境，不会自动加载开发环境配置文件，导致Serilog配置缺失。

具体解决方案 #

1. 补充Application Insights InstrumentationKey配置 #

在对应环境的配置文件（如appsettings.json或appsettings.Production.json）中，给Application Insights接收器添加instrumentationKey参数，直接引用Azure配置的InstrumentationKey：

"Serilog": {
  "Using": ["Serilog.Sinks.Console", "Serilog.Sinks.ApplicationInsights"],
  "MinimumLevel": {
    "Default": "Verbose",
    "Override": {
      "System": "Warning",
      "Microsoft": "Information"
    }
  },
  "WriteTo": [
    {
      "Name": "Console",
      "Args": {
        "theme": "Serilog.Sinks.SystemConsole.Themes.AnsiConsoleTheme::Code, Serilog.Sinks.Console",
        "outputTemplate": "[{Timestamp:HH:mm:ss} {Level:u3}] {Message:lj} ({SourceContext}){NewLine}{Exception}"
      }
    },
    {
      "Name": "ApplicationInsights",
      "Args": {
        "telemetryConverter": "Serilog.Sinks.ApplicationInsights.TelemetryConverters.TraceTelemetryConverter, Serilog.Sinks.ApplicationInsights",
        "outputTemplate": "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} {Level} {Message}{NewLine}{Exception}",
        "instrumentationKey": "{ApplicationInsights:InstrumentationKey}"
      }
    }
  ],
  "Enrich": ["FromLogContext", "WithMachineName", "WithThreadId"]
}

注：{ApplicationInsights:InstrumentationKey}会自动读取Azure App Service配置中ApplicationInsights__InstrumentationKey的值，无需硬编码。

2. 确保生产环境加载正确配置 #

将Serilog配置复制到appsettings.Production.json中，或者在appsettings.json中保留基础配置，让环境配置文件覆盖差异项。Azure App Service会自动根据当前环境加载对应配置文件。

3. 优化BootstrapLogger配置（可选） #

BootstrapLogger用于记录应用启动过程的日志，建议调整其日志级别避免冗余，同时确保与后续Serilog配置不冲突：

Log.Logger = new LoggerConfiguration()
    .MinimumLevel.Warning()
    .WriteTo.Console()
    .CreateBootstrapLogger();

builder.Host
    .UseSerilog((context, loggerConfiguration) =>
        loggerConfiguration.ReadFrom.Configuration(context.Configuration)
                          .Enrich.FromLogContext());

4. 验证依赖包兼容性 #

确保Serilog.Sinks.ApplicationInsights版本兼容ASP.NET Core 8，建议使用最新稳定版（如v4.0.0及以上）。

验证方法 #

部署后，可通过Azure App Service的日志流查看启动日志，确认是否还有初始化错误；同时检查Application Insights的traces表，验证日志是否正常写入。

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